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Introduction 


The User's Guide provides comprehensive information about 
Lotus Agenda® 2.0. It contains the procedures and reference 
information you need to do your job. 


How this Book is Organized 


The User's Guide is divided into five parts: 

• Part I, Getting Started provides an introduction to Agenda® 
concepts and tells you how to create Agenda files and enter and 
categorize your information. 


Part II, Building Your File provides information about how to 
display the information on your screen the way you want it. 

Part II also tells you how to use Agenda features such as dates, 
time, numbers, schedules, and notes as well as information about 
views and view filters. 


Part III, Routine Agenda Tasks provides information about tasks 
you may do frequently such as working with items, editing, 
searching and sorting your information, and printing. Part III also 
explains how to arrange the structure of the categories in your file. 
Part IV, Managing Information Automatically provides informa¬ 
tion about using conditions and actions to automate some of your 
Agenda tasks. 

Part V, Managing Files provides information about working with 
files and importing information to and exporting information 
from Agenda. 

Glossary provides definitions for terms found in boldface type in 
each chapter. 



Appendixes A through J provide additional information about 
Agenda including menu diagrams, a list of indicators, using the 
Agenda accessories, a list of compose characters, managing 
memory for optimum performance, using Agenda on a network, 
protecting Agenda applications, international considerations, 
recovering damaged files, and a list of error messages. 

Index contains an extensive list of topics where you can find fur¬ 
ther information about Agenda. 


Other Agenda Documentation 


For other types of information about Agenda, refer to the documenta¬ 
tion described in the following table. 


Book Description 


Agenda as well as information about updating 
application files from earlier Agenda releases. 
It also provides information about each printer 
that Agenda supports and the Customer 


Working with Macros 


Provides hands-on experience right away. The 
emphasis is on teaching basic skills for using 
and modifying the Activities Planner 



TXT2STF utility. 
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Typographic Conventions 


The User's Guide uses the following typographic conventions: 

The names of Agenda function, accelerator, and special keys are in 
small capital letters. Function keys are identified by the key number 
followed by the Agenda name. 


Key names separated by a hyphen (-) indicate you must hold down 
the first key, press the second key, and then release both keys. 

Example 


Information that you type is in a special typeface. 
Example 

Call Helen about this week's meeting 


When items of information are included in text, they are enclosed in 
quotation marks. 

Example 

You can edit the item "Call Helen about this week's meeting" by 
pressing n (edit). 


Commands, settings, and choices are in boldface type. 

Example 

Press Flo (MENU) and select Category Properties. 

Agenda terms are in boldface type and are defined in the Glossary. 






Part I 

Getting Started 


Chapter 1 Introducing Agenda 

Chapter 2 Everyday Skills 

Chapter 3 Entering and Categorizing Information 

Chapter 4 More about Categorizing Information 



Chapter 1 

Introducing Agenda 


I 


Information comes at you constantly from all directions. You need a 
way to control it and get the most out of it. Agenda helps you man¬ 
age the information. It puts you in control. 


In this Chapter 


This chapter describes 

• A common business problem and how Agenda solves it 

• What you can do with Agenda 

• How you use Agenda 

• Where to go from here 


A Common Business Problem 


Information overload is a common problem in today's business 
world. Imagine yourself in any of the following scenarios: 

• You're a sales manager. You want to turn prospects into clients 
and keep your current clients satisfied. Your tasks include 
managing information about your clients and dealings with pros¬ 
pects, tracking ideas about how to attract and maintain clients, 
and reporting on results. 

• You work in a personnel office. Your tasks include tracking can- 

nating with agencies to find candidates to fill positions, and 
handling internal referrals. 



• You're a product marketing manager. You want to track competi¬ 
tive information about other companies that make products simi¬ 
lar to yours. Your tasks include maintaining information about 
other products and companies, following market trends, 
analyzing competitive information, and brainstorming about how 
to position your product in the marketplace. 

If you have a job like the ones just described, where you manage or 
coordinate tasks, people, projects, time, or events, and where you 
have to make decisions based upon information that comes at you 
daily, you probably suffer from information overload. You have too 
much to do, you are constantly juggling priorities, and when you 
need to make a business decision, you don't always have all the rele¬ 
vant information in front of you. 

Unless you can gain control of all the right information, you won't be 
able to turn disorganized, separate details into information that you 
can analyze and use to make decisions. 


How Agenda Solves the Information Overload Problem 


Agenda is the personal information manager that gives you control 
over all the facts, notes, names, plans, numbers, and dates cluttering 
your desk. You can use Agenda to do the following: 

• Manage activities 

• Keep track of thoughts and ideas 

• Prepare plans 

• Collect meeting notes 

• Keep lists 

• Sift relevant information 


Analyze new 
Refine ideas 
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You've probably already tried to use your computer to help you solve 

the information overload problem. 

• If you've used a database product, you may have found it too 
rigid and complex. 

Agenda gets you started entering information right away, without 
making you set up complicated database structures first. 

• If you've used a word processor to keep lists of ideas and tasks, 
you may have discovered that you can't see the relationships and 

Agenda shows you the relationships among different pieces of 
information, making them much more valuable to you than ever 
before. Agenda can help you see patterns and connections, thus, 
making you better able to analyze and act upon the right 
information. 

• If you've used a desktop utility (for example, a calendaring tool), 
you may have found that it only helps you with one specific infor¬ 
mation management problem—keeping your calendar. 

Agenda is flexible. It can perform many varied functions and can 
be used in many different ways. The section "What Can You Do 
with Agenda?," later in this chapter, discusses just a few of the 
different ways you can use Agenda. 


A Way to See One real strength of Agenda is how it finds the connections among 

All the Angles diverse pieces of information. You start with static and unrelated bits 

of random information like the ones shown in Figure 1-2. 
























Examine Frequently you want to look at the same information from a different 

Information from perspective depending on your needs at the time (Figure 1-8). 

Different 

Perspectives 


Suppose you're the manager of, or work in, a small business. You 
use an Agenda file to track information on clients and the proposals 
you make to clients. 

Agenda lets you look at the same information (in one file) on clients 
and proposals from many perspectives. 

• You're preparing for a meeting on the MediGen proposal. Use 
Agenda to display all information related to the MediGen 
proposal. 

• You're taking Doreen Smith, a dient, out to lunch today. You'd 
like to review any information you have about Doreen and her 
company. Use Agenda to display all information about her and 
her company. 

• You're going to be out of the office next week. Use Agenda to 
display all tasks that you have scheduled for next week so you can 
decide if any of them need to be re-assigned to your assistant. 






Figure 1-8 Agenda lets you look at the same information 
from different perspectives 

Schedule Your Agenda can help you manage your calendar. When you enter tasks, 

Appoi ntments you can also enter dates and times for those tasks. Agenda lets you 

see the events scheduled on your calendar for a specific day, week, or 
month (Figure 1-9). Just as you might browse through your appoint¬ 
ment book. Agenda lets you browse through an online datebook that 






























Produce Reports Agenda can help you summarize information by producing reports. 

Often, producing a report does not involve collecting any new infor¬ 
mation, but simply consolidating information that you already have 
in some other form. When you consolidate the information, you get 
the big picture. You can see connections in what originally were dis¬ 
parate pieces of information. 

For example, you receive many online reports from individuals who 
work for you. You have to summarize the information in the reports 
you receive. Agenda makes it easy to consolidate the information 
you get from the people that work for you into one summary report 
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Applications that 
Get You Started 
Using Agenda 


Agenda provides four starter applications that you can use to manage 
information. You can use them as templates, exactly as they are, or 
you can customize them to meet your specific needs, 
the four applications are 


The Activities Planner application helps you manage and sched¬ 
ule your time. You can use it to manage people and projects, and 
to track responsibilities and expenses. 

• Account Manager 

The Account Manager application helps you handle accounts, as 
well as product, business, and customer issues. If you are a man¬ 
ager, you can use it to consolidate the many activity reports you 
receive from the people who work for you and to analyze account 
and product information. If you're involved in direct customer 
contact, you can manage the abundance of information that you 
continually receive on your accounts, customers, tasks, and 

• People Manager 

The People Manager application helps you manage the goals, per¬ 
formance, and results of the employees who work for you. 

• Information Sifter 

The Information Sifter application helps you sift and sort periodi¬ 
cal abstracts of articles that are stored on CD-ROM. 

For information about how to start using Agenda with these applica- 


How Do You Use Agenda? 


You use Agenda to do the following: 


Display different views of the ir 



you want to track. It 
a specific task ("Call 
the budget reduction 
I (Figure 1-13). 
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enda automatically assigns this item to the categories Fred, Zylet, 











You Can Perform You can perform calcu 

Calculations budget figures or aver, 



You Can Put Extra Items are short pieces ( 
Information in details or lareer amom 
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Where To Go From Here 


There are many different ways to learn to use Agenda. To start 
immediately, do the following: 

• Use Quick Start to learn some basic Agenda skills and concepts. 
Quick Start gives you immediate experience using the Activities 
Planner application. After you complete the exercises in Quick 
Start, you will have a customized file of your own to continue 

• Work through some or all of Starter Applications to see the many 
ways you can use Agenda in your work. 

You can also browse through the User's Guide to get more informa¬ 
tion about Agenda concepts and features. The User's Guide provides 
detailed descriptions and complete procedures for Agenda features 
and functions. 



Chapter 2 
Everyday Skills 


I 


You need a few basic skills to use Agenda. By learning them, you can 
work quickly and effectively. 


In this Chapter 

This chapter describes how to 

• Begin and end an Agenda session 

• Display online Help 

• Use the major Agenda screens 

• Perform tasks with menu commands and keys 

• Work with the boxes that Agenda displays 

• Save time by letting automatic completion do your typing 

• Suspend an Agenda session 

Beginning an Agenda Session 

Before you can begin a session. Agenda must be installed on your 
computer. For instructions on installation, see Chapter 1 in Setting Up 
Agenda. 

To begin an Agenda session: 

1. Make sure you're in the Agenda program directory (for example, 
c:\agenda) or put that directory in your path. 






Quitting from the To quit Agenda from the opening screen: 

Opening Screen 

• Press ESC. 



Ending an Agenda Session 


When you finish working with Agenda, you can quit and return to 
the operating system. 

To end an Agenda session: 

• Press Flo (MENU) and select Quit. 

Agenda automatically saves your work in the current file before it 
ends the session. If you want to quit Agenda without saving changes 
to the current file, use the File Abandon command first. 

(See Chapter 22.) 


Getting Help 


Agenda has an online Help system that is context-sensitive. You can 
display it anytime for immediate assistance. 

To display Help: 

• Press Fi (HELP). 


About Help Help temporarily suspends your work and displays Help informa- 

Screens tion. For example. Figure 2-2 shows the Help screen Agenda displays 

if you press Fi (Help) while working in a view. 
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light the topic, or type it 


Display information on how to use Press fi (on help). 

Display an index of Help topics you Press F3 (index). 
can select from 

Type the name of a topic on which Press F5 (find). (See 
you want Help section.) 

Display a list of Agenda keys and Press F6 (KEYS), 
what they do 

Go back to the previously displayed Press fs (review) or 
Leave Help and return to your Press F9 (return) or 


Many topics have additional Help screens. If a topic has additional 
Help screens. Agenda displays the following in the top right corner 
of the screen: 

• "More: PgDn" to indicate you can press PGDN to display an addi- 


• "More: PgUp" to indicate you can press PGUP to display an addi- 

• "More: PgUp, PgDn" to indicate you can press either PGUP or 
PGDN to display an additional screen 


When you press F5 (FIND), Help prompts you to specify the topic 
about which you want information (Figure 2-3). 


Finding a Topic 
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Using Agenda Screens 


Agenda is made up of three types of screens that you use to do your 
work: views, notes, and the category manager. 

When you display a view, a note, or the category manager, the screen 
is divided into the following three parts: 

• The top part of the screen 

Agenda displays status information (for example, the name of the 
current file) in the top part of the screen. When you press fio 
(MENU), Agenda displays the menu in the top part of the screen. 

• The middle area of the screen 

The middle area of the screen is where you do most of your work 

In a view, it 7 s where you enter and display items and categories. 

In a note, it's where you enter and display the text of a note. In 
the category manager, it's where you display and work with cate¬ 
gories. 

• The function key map 

The function key map appears at the bottom of the screen. It 
shows the function and ALT function keys you can press to per¬ 
form tasks. The keys you see depend on which screen you're 
displaying. 

The following sections show the three different Agenda screens. 


Working with 
Views 


■ and display items and categories (Figure 2-4). 




Moving Around in In a view, move the highlight around the screen by pressing these 

Views keys: 


To move the highlight 
Up one position 
Down one position 
Left one column 
Right one column 
Up one screen 



To the far left column 
To the far right column 






CTRL-PGDN 






!-10 Everyday Skills 


Mo VI ng Aroundin Ina note, move the cursor around the screen by pressing these keys: 

Notes 



To the beginning of the line home 

To the end of the line end 

To the beginning of the note CTRL-HOMl 

To the end of the note ctrl-end 


Working with the You use the category manager to display and work with the catego- 

Category Manager ries in a file (Figure 2-6). 



Figure 2-6 The category manager 




Moving Around in In the category manager, move the highlight around the screen by 
the Category pressing these keys: 

Manager 


To move the highlight Press 

Up one category 
Down one category 
Up one screen 

To the previous sibling 
To the next sibling 
To the parent of the current family 
To the last child of the current 
family 

To the first category in the 
hierarchy (MAIN) 

To the last category in the hierarchy Ctrl-enp _ 

You may be unfamiliar with the terms in the preceding table, but you 
can learn more about them in Chapter 4. 



Understanding Indicators and Symbols 


Agenda displays indicators and symbols on the screen to give you 
status information and helpful information about your file 
(Figure 2-7). 

Indicators are short words that display in the upper right corner of 
the screen. They either tell you about special processing modes 
you're using, such as EDIT, or give you status messages, such as 
WAIT or WRKG. 

Symbols are special characters you may see on the screen. They 
primarily tell you about the characteristics of the items and categories 
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Appendix B includes a list of all indicators and symbols and what 
they mean. Quick Reference includes a list of the most common indica¬ 
tors and symbols. 


Performing Tasks 


To perform any task in Agenda, do one of the following: 

• Select a menu command. 

• Press a key for the task you want to perform. 

The commands and keys available to you depend on where you are 
in Agenda. For example, the menu in a view has different commands 
from the menu in a note or in the category manager. But the way you 
use commands and keys to perform tasks is always the same. 


Displaying Menus Menus list commands you can select to perform tasks in Agenda. 

To display a menu in a view, a note, or the category manager: 

• Press Flo (MENU). 

In a view or the category manager, you can also press / (slash) to 

Agenda displays the menu at the top of the screen. For example. 
Figure 2-8 shows the menu that Agenda displays in a view. The 
highlight is on the first command in the menu (File). The File com¬ 
mands display on the second line. 




Selecting 

Commands 


Canceling 

Commands 


To select a command from a menu, do one of the following: 

• Press the first letter of the command. 

• Use home, or end to highlight the command and press 

Once you select a command. Agenda may prompt you for more 
information before it performs the task. Agenda prompts for more 
information by displaying one of the following: 

• Another menu 

• A box to complete or a box from which you make selections (See 
"Working with Boxes” later in this chapter.) 


If you change your mind while using a menu, you can cancel what 
you're doing. As long as you haven't completed the command, you 
can either back up one step at a time or back all the way out of the 


To back up one step at a time: 

To back all the way out of the menu at once: 
• Press CTRL-BREAK. 


Agenda also provides keys you can press to perform tasks. Some 
keys are shortcuts for menu commands. Others perform tasks not 
available on menus. 



You can use three different kinds of keys in Agenda. 

• Function keys 

• Accelerator keys 

• Special keys 

Function Keys 

Agenda provides two sets of function keys to perform tasks. 


• ALT-F1 through ALT-FIO 

You use alt-fi through alt-fio by holding down alt and press¬ 
ing the appropriate function key. 

To see which function keys you can use and what they do, look at the 
function key map at the bottom of the screen. It shows Fi through Flo. 
To display the function key map for the ALT keys, press alt. 

To turn the display of the function key map on or off: 

• Press alt-k. 

Accelerator Keys 

Another way you can perform tasks is to hold down the alt key 
while you press certain letter and number keys. These keystroke 
combinations (such as alt-a or alt-i) are called accelerator keys. 
Typically, accelerator keys are shortcuts that you'll use as you gain 
more experience using Agenda. 

To see a list of the accelerator keys and learn what they do: 

Agenda displays a Help screen. 

Agenda displays a chart of keys and menus. 

3. Highlight "Accelerator Keys" and press ENTER. 

Agenda displays a list of accelerator keys. 

Quick Reference also includes a list of the accelerator keys. 
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Special Keys 

Special keys let you move around in Agenda and perform certain 
tasks (Figure 2-9). 
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Figure 2-9 Keyboard showing Agenda special keys 


Working with Boxes 


When you perform tasks. Agenda sometimes displays boxes that con¬ 
tain settings that you need to complete (Figure 2-10). 
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The following sections describe how to work with boxes. 


Moving Between When Agenda displays a box with multiple settings, you move the 
Settings highlight around the box to complete them. 


To move the highlight Press 



To the first setting in the box 
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CCompleting You don't usually need to complete every setting in the box. Somi 

bettings settings are optional and others automatically have a default choic 

For those settings you do need to complete. Agenda provides a fei 
techniques to make it faster and easier. 

To select a choice for a setting in a box, highlight the setting and do 
one of the following: 

• Press F3 (CHOICES) to display a list of choices from which you can 

See "Selecting from a List" later in this chapter. 

• Press SPACE BAR to cycle through the choices one at a time. 

• Press the first letter of the choice you want. 

If a setting doesn't provide a list of choices, do one of the following: 

• Type your own choice and press ENTER. 

• Press F2 (edit) to edit the existing choice for the setting. 

• Press ctrl-enter to clear the existing choice for the setting. 

Notice that when you highlight a setting. Agenda displays additional 
information about the setting at the top of the screen (Figure 2-10). 

If a setting contains ellipses (...), such as Advanced settings in Figure 
2-10, it means that Agenda displays a second box with additional 
settings. To display the additional settings: 

• Highlight the setting with the ellipses and press SPACE BAR. 


Restoring Defaults After you select a different choice for a setting, you may decide to 
for Settings use the default instead. 

To restore the default for a setting: 

• Highlight the setting and press F8 (DEFAULT). 

To restore the defaults for all settings in the box: 

• Press ALT-18 (DFLTALL). 

Note You can use the File Properties command to change what 
Agenda uses for defaults in certain settings. If you do, F8 
(DEFAULT) and ALT-F8 (dfltall) restore these settings to the 
new defaults you specify, not back to the original defaults. 
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Note If all of the choices don't fit in the box. Agenda displays an 
arrow to indicate which way to move to see the rest of the 
choices. If there are more choices at the bottom of the box. 
Agenda displays l at the bottom of the box. If there are more 
choices at the top of the box. Agenda displays t at the top of 


Saving Time with Automatic Completion 


Whenever you start to type a choice. Agenda tries to match what you 
type with the choices that are currently available. This time-saving 
feature is called automatic completion. 

Agenda uses automatic completion when you 

• Specify an existing category 

• Select from a list 


When YOU Specify When you start to type a category name, Agenda compares what you 

an Existing type with the categories in the file. Agenda then displays the first 

Category match it finds (Figure 2-12). 





To select the category Agenda displays: 


Note Agenda limits its search to appropriate categories. For exam¬ 
ple, when you type a category as a column entry in a Priority 
column. Agenda searches only for the existing priorities 
(High, Medium, and Low). 



When Several Often, more than one category matches whi 

Categories Match example, the line at the top of the screen in 
file contains three categories beginning wit! 
To narrow the search, do one of the followii 

• Press F8 (NEXTSEL) or F7 (PREVSEL) to cycli 
You can also use alt-n (next) and alt-p 

• Press F3 (CHOICES) to display the categor 
Then press T or i to move the highlight < 
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Customizing Your Environment 


Agenda lets you modify and customize your Agenda environment. 
The next two sections discuss how to customize: 

• Whether Agenda displays the function key map at the bottom of 

• Whether Agenda prompts you for confirmation before performing 


Turning Off the By default. Agenda displays the function key map at the bottom of 
Function Key Map the screen. To turn off the display of the function key map, do the 
following: 

1. In a view, press Flo (menu) and select Utilities Customize. 
Agenda displays the Utilities Customize box. 

2. Highlight Display key map and choose No. 

3. Press enter. 

Agenda returns you to the view, but does not display the function 
key map. 


Conf i rmIng In certain cases. Agenda prompts you to confirm that you want to 

Commands perform the task you select. When you make changes that delete 

information or would be difficult to undo (for example, discarding a 
category or an item). Agenda prompts you for confirmation. 

After you've used Agenda for a while, you may decide you don't 
want Agenda to prompt you for confirmation. 

To set Agenda to perform tasks without prompting for confirmation, 
do the following: 

1. In a view, press Flo (MENU) and select Utilities Customize. 
Agenda displays the Utilities Customize box. 

2. Highlight Confirm mode and choose No. 

Agenda returns you to the view. 
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Suspending an Agenda Session 


You can temporarily suspend an Agenda session to use the operating 
system. Once there, you can enter operating system commands or 
run another program. When you finish, you return to your Agenda 
file at the point where you left it. 

To suspend an Agenda session from a view: 

1. Press Flo (menu) and select System. 

Agenda saves the file and takes you to the operating system. 

2. Enter the operating system command(s) you want to perform. 

See "Guidelines for a Suspended Session" later in this chapter. 

3. To return to Agenda, type exit and press enter. 

Agenda returns you to your Agenda file at the point where you left it. 

Launching a If you want to suspend an Agenda session and start another program. 

Program from there's a faster way than using the System command. You can 

Agenda launch another program from Agenda. 

To launch a program from a view: 

1. Press Flo (MENU) and select Utilities Launch. 

Agenda prompts you to enter the name of the program you want 

2. Type the name of the program (including the full path, if neces¬ 
sary) and press ENTER. 

Agenda suspends your session and runs the program you 

3. When you finish using the launched program, exit from it as you 
normally would. 

Agenda returns you to your Agenda file at the same 


: point you left it. 



Guidelines for a 

Suspended 

Session 


Don't ran terminate-and-stay resident (TSR) programs such 
Lotus Metro® or Borland Sidekick®. 

Don't use memory-resident DOS commands such as 
PRINT.COM or MODE.COM unless you load them before sta 
Agenda. (You may want to use the AUTOEXEC.BAT file to 1 
them automatically.) 


Chapter 3 

Entering and Categorizing Information 


I 


Agenda makes it easy to keep track of many pieces of information. 
These pieces of information are called items, and the way you track 
them is by assigning them to categories. 


In this Chapter 

This chapter describes how to 

• Enter, edit, and discard items of information 

• Assign items to categories 

• Add columns and assign items to categories in columns 

• Remove columns 


About Items 


An item is the basic unit of information in Agenda. An item can be a 
few words or a more lengthy description of an idea, a concept, or a 
specific task. Agenda displays the items in a column. Figure 3-1 
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Discarding Items from a File 


You can discard an item entirely from your file. When you discard 
an item, it goes into the trash, a temporary storage place for dis¬ 
carded items. When you empty the trash, the item is no longer in the 
file. (See Chapter 13.) 

To discard an item from a file: 

1. Highlight the item you want to discard. You can discard more 
than one item at a time by highlighting each one and pressing 
F7 (MARK). Agenda places a diamond (♦) beside each marked 

2. Do one of the following: 

• Press Fio (MENU) and select Item Discard. 

• Press ALT-F4 (DISCARD). 

If there are marked items. Agenda asks you what you want to 

3. If you have marked items, do one of the following: 

• Choose Marked items and press ENTER to discard all marked 

• Choose Current item and press enter to discard only the 
currently highlighted item. 

Agenda asks whether you want to discard the item(s). 

4. Press ENTER to discard the item(s). 

Agenda discards the itemfe) from your file. 


Undiscarding When you discard items. Agenda puts them in the trash until you 

Items empty the trash. (See Chapter 13). As long as the trash is not emp¬ 

tied, you can recover items you discard. You can choose to recover 
all items discarded since you last emptied the trash or only the last 
item. You can put undiscarded items anywhere in the file. 

To recover the items you discard: 

% Highlight the item above which you want to place the undis¬ 
carded item(s). 


2. Press no (MENU) and select Item 1 
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About Assignments 


An assignment is the connection between an item and a category. 
Each time you enter an item, you assign it to a fcategory. You can 
assign an item to many categories; many items can be assigned to one 

Figure 3-4 shows the assignments of an item to several categories. 



Displaying Items and Categories 


In Agenda, you display items and the categories which they belong to 
in views. Categories can be 

• Section heads 

• Column heads 








Figure 3-6 Categories used as section heads 

Categories as You can assign items to several different categories by adding catego- 

Column Heads ries as column heads (figure 3-7). 






Categ O r i es as Once you add categories as column head; 

Column Entries gories as column entries under the colun 
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• Numeric 

You use numeric categories to display numbers. You can perform 
simple calculations on the numbers in a numeric column. (See 
Chapter 8.) 

• Unindexed 

You use unindexed categories to display unique text values. Text 
values are letters and/or numbers such as part numbers or street 
addresses. Each item assigned to an unindexed category has one 
text value. For example, any item assigned to the category 
Address can have only one text value for Address. (See "Assign¬ 
ing Items in Unindexed Columns" later in this chapter.) 


Examples Of Figure 3-9 shows a view containing standard categories. 

Category Types 6 



Figure 3-10 shows a view that uses the date category. When, and the 
numeric category. Cost, as column heads. 

The dates in the When column are date values, not categories. If you 
enter a date in a column, you assign the adjacent item to the date 
category with a date value. For example, the item "Send report to 
Carla” is assigned to the When category with the date 11 /21 /90. 












Assigning Items to Categories 


When you enter an item, you assign it to the category used as 

shows items assigned to the Calls category (the first section he 
and items assigned to the Meetings category (the second sectii 



Figure 3-12 Items assigned to the Calls category and 
Meetings category 


You can assign each item to additional categories. Agenda displays 
category assignments as section heads or as column entries. For 
example, the first item in Figure 3-12 is assigned to the categories 
Marianne, Peter, and Calls. 
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About Columns A column that displays assignments consists of a column head (cate¬ 
gory) and one or more column entries (categories). A column that 
displays items consists of a section head (category) and the items you 
assign to the section head (Figure 3-15). (For more information about 
items that appear in columns, see "Modifying Columns Containing 
Items" later in this chapter.) 
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If you move a column, however, you must move it one section at a 
time even if the column displays in all sections. 

Note If Agenda beeps when you add a column, you don't have 
enough space in the view for the column width. You can 
make space for the new column by adjusting the width of 01 
or more columns in the view. (See "Adjusting Column 
Widths" in Chapter 5.) 


Shortcut tO Adding Accelerator keys provide a shortcut to adding columns. 

Columns 

To add columns using accelerator keys: 

1. Press ALT-R to add a column to the right of the highlight or ALT-L 
to add a column to the left of die highlight. 

Agenda displays the Column Head box. 

2. Do one of the following: 

• Highlight the category you want to display as the column 
head and press enter. 

• Type a new category name and press enter. 

Agenda adds a column head using the category you select. If you 
type a new category name. Agenda adds this category to your file. 
The column displays in one section or all sections. The Insert new 
columns in setting in the File Properties box determines whether the 
column you add appears in all sections or the current section only. 

Mod ify i ng You use the Column Properties settings to review and modify the 

Co IU m n characteristics of a column. You can edit the column head, change 

Properties the column type, width, and format, and you can link columns 


To modify a column: 

1. Highlight the column head and do one of the following: 

• Press F6 (PROPS). 

• Press Fio (MENU) and select View Column Properties. 
Agenda displays the Column Properties box. The settings are 
described in the following section. The settings vary depending 
on the type of category displayed as the column head. 



Column Add/ 
Column Properties 
Settings 
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2. Complete the settings and press ENTER. 

Agenda modifies the column according to the changes you specify. 


You use the Column Add settings to specify the characteristics of a 
new column. The Column Properties settings let you modify existing 
columns. These settings are described below. 

Column head Specify the category that you want to use as the 
column head. In the Column Properties box. Agenda displays the 
current column head. You can edit or replace this category. 

To specify the category you want to use as a column head, do one of 
the following: 

• Type the name of a new or existing category. 

• Press F3 (CHOICES) and select an existing category. 

Category type Specify the type for the category used as the column 
head. If you choose a date, numeric, or unindexed category, you 
can't change it to another category type. 






Standard (default) 


displays the Format setting. 

Agenda displays numbers. Agenda displays additional 
settings for numeric format. (See Chapter 8.) 

Agenda displays dates. Agenda displays additional 
settings for date formats. (See Chapters 6 and 7.) 
Agenda displays category text values such as phone 
numbers or addresses. (See "Assigning Items in Unin¬ 
dexed Columns" later in this chapter.) 


Format Specify how to display the assignments for standard catego¬ 
ries or how to display dates and numbers for date and numeric 
categories. If you specify a date or numeric category. Agenda 
displays the related format settings. For example, you can choose 
whether to display the name of the category or some text from a note 
for a standard category. (See Chapter 5 for more information about 
standard column formats. See Chapters 6 and 7 for a description of 
date category formats and Chapter 8 for numeric category formats.) 
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To modify the column containing items: 

1. Highlight any item in the column. 

2. Press Flo (MENU) and select View Column Properties. 

Agenda displays the Item Column Properties box. The settings 
are described in the following section. 

3. Complete the settings and press enter. 

Agenda modifies the column according to the changes you specify. 

Item Column You use the Item Column Properties settings to modify the column 

Properties; containing items. 

Section head Specify the category that you want to use as the sec¬ 
tion head. Agenda displays the current section head. You can edit or 
replace this category. 

To specify a section head, do one of the following: 

• Type the name of a new or existing category. 

• Press F3 (CHOICES) and select an existing category. 

Width Type a number between 5 and 77 to change the width. 

Agenda displays the current column width. 

Set width Specify how the column width is adjusted. 



Minimum width Specify the minimum width of the column. 

Agenda displays the Minimum width setting if you choose Automat¬ 
ically for Set width. 

Link with other sections Specify whether you want to link or 
unlink this column of items with the item column in other sections. 
The choices are Yes (default) and No. (See Chapter 5.) 
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Shortcuts to There are several shortcuts for entering items or categories quickly. 

Entering Items The following table summarizes these shortcuts. 

or Categories 


Enter a new item when the highlight is in a ALT-I 


Complete an item and move the highlight to the tab 
category 

Complete an item and move the highlight to the shift-tab 
next column to the left so you can enter a 

cate g°ry _ 


In some cases you want to assign one text value to a particular item. 
Text values can be any combination of letters and numbers such as 
part numbers, employee identification numbers, or invoice numbers. 
For example, if you keep a list of names and phone numbers in your 
Agenda file, each phone number is assigned to one name. 

You use an unindexed column to display these text values. An unin¬ 
dexed column consists of a column head (an unindexed category 
such as Phone) and column entries that are text values (such as the 
actual phone numbers) (Figure 3-22). 



Figure 3-22 Rolodex view with unique phone numbers 

The text values in unindexed columns are not categories. These text 
values assign an item to an unindexed category. 

To assign items in unindexed columns, you must add an unindexed 
column to a view or convert an existing category to an unindexed 
category. 
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When you highlight an unindexed category or value. Agenda dis¬ 
plays a symbol (A) in the upper right comer of the screen. 

Adding an unindexed column 

You can add an unindexed column to a view to display text values. 
You can head the unindexed column with: 

• An existing unindexed category 

• A new unindexed category 

• A category you convert from a standard category to an unindexed 
category 

To add an unindexed column to a view: 

1. Place the highlight in the section or column next to where you 
want to add the unindexed column. 

2. Press Flo (MENU) and select View Column Add. 

Agenda displays the Column Add box. 

• Type the name of the unindexed category you want to use as 
the column head and press enter. 

• Press F3 (CHOICES), highlight an unindexed category, and 

4. If you specify the name of a new category as the column head in 
Step 3, do both of the following: 

• Highlight Category type and press F3 (CHOICES). 

• Highlight Unindexed and press ENTER. 

5. Complete the settings and press ENTER. 

Agenda adds an unindexed column to the view. 

Converting a standard category to an unindexed category 

You can convert a standard category to an unindexed category. 
Before you convert a standard category to an unindexed category, 
you need to know the following: 

• After you convert a category to an unindexed category, you can- 
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• When you convert a category to an unindexed category, all col¬ 
umns headed by that category in all views become unindexed 
columns. 

• You cannot convert an unindexed category that has more than one 
category level. To see the number of levels, highlight the category 
and press F9 (CAT MGR) before you convert the category. (See 
Chapter 5 for information about category relationships.) 

• If the standard category has child categories (categories related to 
parent categories). Agenda converts them to text values when the 
category is converted. 

To convert a standard category to an unindexed category: 

1. Highlight the category you want to convert. 

2. Press Flo (MENU) and select Category Properties. 

Agenda displays the Category Properties box. 

3. Highlight Type and press F3 (CHOICES). 

4. Highlight Unindexed and press ENTER twice. 

If the category has no assignments. Agenda converts the stan¬ 
dard category to an unindexed category. 

If the category has assignments. Agenda asks you if you want to 
convert the standard category to an unindexed category. 

5. Press ENTER to confirm that you want to convert the category. 

Agenda converts the standard category to an unindexed category. 

Entering text values in columns 

To enter text values in a column: 

• Highlight the column entry adjacent to the item you want to 
assign, type the appropriate text value, and press ENTER. 

The item is assigned to the unindexed category with the text value 

you type. 










Chapter 4 

More about Categorizing Information 


I 


You organize your information in Agenda by entering items and 
assigning them to categories. Agenda lets you create the structure for 
your information as you enter it. 


In this Chapter 


This chapter describes 

• How categories are related 

• Making explicit and conditional assignments 

• Breaking assignments 

• Discarding categories 

• Modifying item assignments 

• Using assignment profiles to display, make, or break assignments 


How Categories Are Related 


A file can contain many categories. You can assign items to as many 
categories as you want. When you enter categories in columns, you 
assign adjacent items to these categories. 
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you also assign the item by inheritance to the parent category (such as 
Priority). In Figure 4-2, the item "Send report to Carla" is assigned to 
the categories Priority and Medium. 


Looking at 
Category 
Relationships 


To see how categories are related to each other, you refer to the cate¬ 
gory hierarchy. The category hierarchy lists all of the categories in 
the current file and shows the structure of the file by indenting child 
categories under their parent categories (Figure 4-3). 

You can refer to the category hierarchy using the category manager, a 
screen that lets you work with the category hierarchy. 

To display the category hierarchy in the category manager: 

• In a view, press F9 (cat mgr). 

Agenda displays the category hierarchy in the category manager. 



Figure 4-3 The category hierarchy in the category manager 


Selecting 
Categories from 
the Category 
Hierarchy 


In a view, you can select categories from the category hierarchy to fill 
in a column. This procedure is useful if you want to quickly assign 
an item to one or more existing categories. For example, you can 
easily assign the item "Bill and Sue to present Dean project status at 
10:00 tomorrow" to the existing categories Bill and Sue under the 
Who column head. 


To enter categories in a column from the category hierarchy: 


1. Place the highlight in the column adjacent to the item that you 
want to assign to a category. 
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2. Press F3 (CHOICES). 

Agenda displays part of the category hierarchy. Specifically, 
Agenda displays the children of the category used as the column 
head as well as the column head itself. 

3. Highlight a category and press SPACE bar. 

Agenda displays a star (*) beside the category that you select. 

4. Repeat Step 3 for each category to which you want to assign this 


If the categories are mutually exclusive (that is, an item can be 
assigned to only one of the child categories). Agenda removes 
the first star when you select another category. 

5. Press enter. 

Agenda displays the category or categories you select as entries in the 
column and assigns them to the adjacent item. 

Tip Any time you highlight a category or a setting that requires a 
category name, press F3 (CHOICES) to display the category 


For more information about working with the category hierarchy, see 
Chapter 16. 


Shortcut for Making Assignments 


You can assign items to any category using an accelerator key. You 
can use this method to assign an item (or a group of marked items) to 
any category including a category not displayed in the current view. 
This key is a shortcut for the Item MakeAssign command. 

To use an accelerator key to assign an item or group of items to one 
category: 


1. Highlight the item you want to assign. You can assign a group of 
items to a category by highlighting each item and pressing 


If you have marked items. Agenda asks whether you want to 
assign the marked items or the current item. 
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3. If you have marked items, do one of the following: 

• Choose Marked items and press ENTER to assign all marked 

• Choose Current item and press enter to assign only the cur¬ 
rent item. 

4. To select a category, do one of the following: 

• Type a category name and press ENTER. 

• Press F3 (CHOICES), highlight an existing category, and press 

Agenda makes the assignments you select. 


Making Explicit and Conditional Assignments 

Not all assignments are alike. Assignments can be either explicit or 
conditional. 

An explicit assignment is an assignment you enter, and it remains 
until you break it. For example, if you type the item "Get status of 
Ringwald account", you can type John in the adjacent Contact col¬ 
umn to assign the item to the John category (Figure 4-4). 



you explicitly break the assignment. See "Breaking Assignments 
later in this chapter. 


If you type a date in the When column for this item, you also make an 
explicit assignment (Figure 4-5). 





Agenda has the flexibility to make assignments for you. An assign¬ 
ment that Agenda automatically makes for you is a conditional 
assignment. For example, if John is an existing category in your file, 
you can type the item, "Send meeting minutes to John", and Agenda 
automatically assigns the item to the John category (Figure 4-6). The 
assignment Agenda makes is conditional because it depends on the 
name John appearing in the item. 





If you type an item and it includes a date. Agenda automatically 
assigns a date to the item. For example, if you type an item such as 
"Meet with John tomorrow". Agenda automatically assigns the item 
to the When date category (Figure 4-7). The assignment Agenda 
makes is conditional because it depends on the date appearing in the 
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Informatic 


Tip To see if an assignment is explicit or conditional, check the 

assignment profile of an item. See "Using Assignment Profiles" 
later in this chapter. 


How to Make There are several ways to make assignments and several ways 

Explicit or Agenda automates the assignment process for you. The following 

Conditional table summarizes how to make explicit and conditional assignments 

Assignments 




Explicit assignment Type a category in a column adjacent to an item. 

Type, move, or copy an item into a section. 

Set up a^n explicit automatic assignment called an 

Conditional assignment Type the name of an existing category in an item. 

Type certain words or phrases in an item that 
Agenda matches to a category name. 

(See Chapter 19.) 

Set up a conditional automatic assignment called a 
_condition. (See Chapter 20.) 


Breaking Assignments 


Breaking an assignment breaks the connection between an item and i 
category. Both the item and category, however, remain in your file. 
There are several ways you can break the assignment of an item to a 
category. You can break assignments by removing an item from a 
section or by removing a category from a column. The following 
table summarizes how to break an assignment. 
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Highlight the item and press DHL or press 
Flo (MENU) and select Item BrkAssign 


Highlight the category and press DEL or press 


Use the Assigned to setting in the Item Properties 

fying Item Assignments" and "Using Assignment 
Profiles" later in this chapter. _ 


Caution If you break an item's only assignment. Agenda discards 
the item from the file. For example, if the item "Call about 
new account" is assigned only to the Calls category, you 
discard the item from the file if you break this assignment. 
As long as the item has other assignments, however, the 
item remains in the file. You can recover discarded items 
from the trash, a temporary storage place. (See Chapter 3.) 


Removing Items When you remove an item from a section, you break the assignment 
from a Section of that item to the category used as the section head. You remove the 

item from the current section only. The item remains in your file and 
you do not break the item's assignments to any other categories. 

To break the assignment of an item to the category used as the section 
head and remove the item from the section: 
t. Highlight the item you want to remove and press DEL. 

If the item is assigned to any category other than the category 
used as a section head. Agenda asks if you want to remove the 


If an item is not assigned to any category other than the section 
head. Agenda asks you if you want to discard the item because it 

the item. Discarding the item puts the item in the trash. 

2. Press entek. 

Agenda either removes the highlighted item from the current sec¬ 
tion (the item is no longer assigned to the category used as the 
section head but remains in the file) or discards the item from the 
file because it has no category assignments. Every item must have 
at least one category assignment to remain in a file. 
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If you move an item from one section to another you also break the 
item's assignment to the original category used as a section head. 
(See Chapter 13.) 

Tip You can mark several items in a section and remove them as a 
group. (See Chapter 13.) 


Recovering the Agenda tracks the last item you removed. If you accidentally remove 

Last-removed Item an item, you can put the item back where it was or you can insert it in 
a different section. 

To recover the last-removed item: 

• Highlight the item above where you want to insert the 
last-removed item and press ALT-Y. 

Agenda inserts the item in the current section and assigns it to the 
category that heads the section. 

Note Agenda tracks only one removed item at a time. You cannot 
use this procedure if you remove a group of marked items. 


Removing 
Categories 
from Columns 


If you no longer want an item to be assigned to a category in a col¬ 
umn entry, you can remove the category from the column. When 
you remove a category from a column, you break the assignment of 
the adjacent item to that category. The category remains in your file. 
To break an assignment by removing a category from a column: 

1. Highlight the category that you want to remove from the column 
and press del. 

Agenda asks you if you want to remove the item's assignment to 
the category. 

2. Press ENTER. 

Agenda removes the category from the column. The adjacent item is 
no longer assigned to that category. 
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Discarding Categories from a File 


You can discard categories from your file when you no longer need 
them. For example, if you have employee names as categories in a 
file and an employee changes jobs to another company, you can per¬ 
manently discard that person's name from your file. You can discard 
categories from a view or the category hierarchy (see Chapter 16). 

Once you discard a category, it no longer appears in the category 
hierarchy and the category no longer displays in other views. In 
addition. Agenda breaks all assignments to the category and removes 
all sections or columns that use the category as a section head or 
column head. 

If there are items assigned only to the categoiy you discard. Agenda 
discards those items. Unlike discarded categories, however, you can 
recover discarded items from the trash. 

To discard a category permanently from the file: 

1. Highlight the category you want to discard. 

2. Do one of the following: 

• Press ALT-F4 (DISCARD). 

• Press Fio (menu) and select Category Discard. 

If the category has items assigned to it or if it has children. 
Agenda asks you if you want to discard the category. 

3. Press ENTER to discard the category. 

Agenda discards the category from your file. 


Breaking Assignments Versus Discarding Items and Categories 


When you remove an item or a category from a view, you break the 
assignment between the item and the category. The item and cate¬ 
gory remain in your file but the connection between them is broken. 
When you discard an item or a category, the item or category is no 
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• in the file. The following table summarizes 
en breaking assignments and discarding iten 


the differences 
tis and categories 


Highlight the iteir 
Item BrkAssign 


and The assignment 


The item (if it has other 
assignments) and cate¬ 
gory remain in the file. 



se Category Discard 


Moving an item from one section to another affects the item's assign¬ 
ments. (See Chapter 13.) 


Modifying Item Assignments 


Because an item can have multiple category assignments and appear 
in more than one view, you may want to review all the assignments 
for, and information about, a single item. 






Agenda displays the name of the category and any dates, 
numbers, or text values next to the category in parentheses. 

• Highlight a category and press del to break an existing 
assignment. 

• Press F3 (CHOICES) to make or break one or more assignments. 
Agenda displays the assignment profile. See "Making and 
Breaking Assignments Using the Assignment Profile" later in 
this chapter. 

• Highlight a category, press F4 (values), edit the value in the 
upper left comer of the screen, and press ENTER to change the 
date, number, or text value for a category. 

3. Complete the settings and press ENTER. 

Agenda displays the item with any changes you make. 





Item Properties 
Settings 


You use the Item Pi 
characteristics of at 
Item text Edit the 
sary changes, and j 
Note Press space 
can edit the note ar 
Properties box. 
Note file Specify 2 
Item statistics Pr 










Using Assignment Profiles 


Agenda provides a list of categories to which the current item is 
assigned called an assignment profile. The assignment profile lets 

• Display both explicit and conditional category assignments 

• Add or remove category assignments 

You can use an assignment profile for a single item or for a group of 
marked items. 


Displaying the You can display the assignment profile for a single item to review 

Assignment Profile and modify its assignment. 

for an Item 


To display the assignment profile for a single item: 

• Highlight the item and press F3 (choices). 

Agenda displays the assignment profile and the category hierarchy. 

A star (*) indicates an explicit assignment. A star followed by c (*c) 
indicates a conditional assignment. 

Figure 4-11 shows the assignment profile for the item "Call Anna 
Lasky today with the information she requested". The assignments to 
the Entry date and Calls categories are explicit. The assignments to 
the When date and Anna Lasky categories are conditional because 
Agenda makes them automatically based on the text of the item. 
Explicit assignments are preceded by a symbol (*); conditional assign¬ 
ments are preceded by another symbol (*c). 

In an assignment profile, values for date, numeric, and unindexed 
categories display on the line below the category name. For example, 
the Entry date in the assignment profile in Figure 4-11 is 07/05/88. 
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Making and To use the assignment profile to make or break assignments for an 

Breaking Assign- item: 
ments Using tne 
Assignment Profile 

1. Highlight the item and press F3 (CHOICES). 

Agenda displays the assignment profile for the current item. 

2. Do one of the following: 

• Highlight a category and press SPACE BAR or F7 onclcat) to 
make an assignment. 

If you enter the name of an existing date, numeric, or unin¬ 
dexed category. Agenda prompts you for a date, number, or 
text value in the upper left comer of the screen. Type a date. 

Agenda displays a symbol (*) beside the category to indicate 
that the item is assigned to that category. 

• Highlight a category preceded by a symbol (* or *c) and press 
SPACE BAR to break an assignment. 

removes the symbol (* or *c). 


Agenda i 
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3. Press ENTER to accept the assignment changes. 

Agenda displays the items and their assignments. Agenda displays a 
question mark (?) next to a category if the item has suggested assign¬ 
ments to confirm. (See Chapter 19.) 


Using the You may also want to review and modify the assignments for a 

Assignment Profile group of marked items. You can use assignment profiles for groups 
for a Group Of of marked items to assign or unassign all items in the group to one or 

Items more categories. 

To display, make, or break assignments for a group of marked items: 

1. Highlight each item you want to work with and press F7 (MARK). 

2. Press F3 (CHOICES). 

Agenda displays the assignment profile for the group of items. 
The number beside each category indicates how many items in 
the group are assigned to a particular category (Figure 4-12). 

3. Do one of the following: 

• Highlight a category not preceded by a number and press 
SPACE BAR or F7 (INCLCAT) to make an assignment to all 
marked items. 

If you enter the name of an existing date, numeric, or unin¬ 
dexed category. Agenda prompts you for a date, number, or 
text value in the upper left comer of the screen. Type a date, 
number, or text value and press ENTER. 

Agenda displays a number beside the category to indicate 
how many items you assigned to the category. 

• Highlight a category preceded by a number and press 
SPACE BAR to break the assignment of all marked items to a 
category. 

Agenda removes the number. The marked items are no 
longer assigned to that category. 

4. Press ENTER to accept the assignment changes. 

Agenda displays the marked items and their assignments. 
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Chapter 5 

Modifying the Display 


Agenda displays items and categories in columns and sections. For 
example, you might want to list calls, memos, and prospects in sec¬ 
tions with their associated activities. You can also add columns to 
those sections showing the completion date and priority for these 
activities. 

You can customize how Agenda displays your information by modi¬ 
fying sections and columns in a variety of ways. For example, you 
can add or remove sections, replace categories, or change column 
widths and column formats. 


In this Chapter 


This chapter describes how to 

• Add, modify, remove and move sections in a view 

• Insert lines between sections and number the items in a section 

• Hide sections with no items or hide repeating column heads 

• Replace categories to rearrange your view 

• Edit category names 

• Move columns and adjust column widths 

• Insert columns in one or all sections 

• Link and unlink columns to work with columns individually or as 

• Change column formats 

• Work with standard column formats 
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You can add additional sections to any view. If you select an existing 
category as a section head, you can look at all the items assigned to it. 
For example, if you add a Calls section. Agenda displays all items 
assigned to Calls. If you want to organize your information in a new 
way, you can add a section head that is not already a category. 
Agenda creates the category and adds it to your file. 

Note You can enter and display numbers, dates, and text values in 
columns. These column entries such as 11/2/90 or $33, how¬ 
ever, are not categories. Therefore, they cannot be used as 
section heads. For more information about numeric 
categories, see Chapter 8. For more information about date 
categories, see Chapter 6. For information about unindexed 
categories, see Chapter 3. 

To add a section: 

1. Press Flo (MENU) and select View Section Add. 

Agenda displays the Section Add box. The settings are described 
in "Section Add/Section Properties Settings” later in this chapter. 

2. Specify the category you want to display as a section head by 
doing one of the following: 

• Type the name of a new or existing category and press ENTER. 

• Press F3 (CHOICES) and select an existing category. 

3. Complete the settings and press ENTER. 

Agenda adds the section to the current view and displays any items 
assigned to the section head category. 

Tip To display all the children of one category as section heads, see 
"Displaying All Child Categories in a View" in Chapter 9. 

Shortcuts to Accelerator keys provide a shortcut to adding sections. 

Adding Sections 8 

To add a section using accelerator keys: 

1. Move the highlight to anywhere in the section below or above 
where you want to add a new section. 

2. Press ALT-D to add a section below the current section or ALT-U to 
add a section above the current section. 

Agenda displays the Section Head box. 
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3. Specify the category you want to display as a section head by 
doing one of the following: 

• Type the name of a new or existing category and press enter. 

• Press F3 (CHOICES) and select an existing category. 

Agenda adds the section to the current view and displays any items 
assigned to the category used as the section head. 


Modifying Sections 


Agenda lets you change sections to suit your own needs. You can 
replace the section with a new or existing category. You can also add, 
remove, or edit columns, sort items, select calculations for any 
numeric columns in the current section, or filter information. You 
use the Section Properties settings to modify a section. 

To modify a section: 

1. Do one of the following: 

• Highlight the section head and press F6 (props). 

♦ Place the highlight anywhere in the section, press Flo (menu) 
and select View Section Properties. 

Agenda displays the Section Properties box. The settings are 
described in the following section. 

2. Complete the settings and press ENTER. 

Agenda modifies the section according to the changes you specify. 
You can replace section heads to modify your view. See "Replacing 
Categories” later in this chapter. You can edit the category used as 
the section head. See "Editing Category Names" later in this chapter. 
Tip You can replace and rearrange sections using the 
View Properties command. (See Chapter 9.) 
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Section Add/Section Properties Settings 


You use the Section Add settings to add a new section. You use the 
Section Properties settings to replace or modify the current section. 
The Section Properties box displays the current section head category, 
columns, filters, and so forth for the current section. These settings 
are blank in the Section Add box. The Section Add box displays an 
additional setting. Insert. 

Section head Specify the category that you want to use as the sec¬ 
tion head. In the Section Properties box. Agenda displays the current 
section head. You can edit or replace this category. 

To specify a section head do one of the following: 

• Type a new or existing category name and press enter. 

• Press F3 (choices) and select an existing category. 

Agenda replaces the current section head with the category you spec¬ 
ify and displays any items assigned to that category. If you type a 
new category name. Agenda adds this category to the file. 

Insert (Section Add only) Indicate where to place the section in the 
view. The choices are Below current section (default) or Above 


Col umns Specify the category or categories that you want to use as 
column heads. You can type new category names or select existing 
ones. The Section Properties box displays the current column heads. 
You can add, remove, or edit existing categories that are used as col¬ 
umn heads in all sections. Agenda displays any existing column 
heads and <Items> for the column of items. 

To add column heads, do one of the following: 

• Type a new or existing category name and press enter. 

• Press F3 (choices) and select existing categories from the category 

• Press alt-r or ALT-L, type a new or existing category name, and 
press enter to add a column to the right or the left of the current 

Repeat the procedure for each column head you want to add to all 
sections in the view. Once you alter a category name, you can press 
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F2 (EDIT) to edit it, del to remove it, alt-fio (move) to move it, or 
F6 (PROPS) to specify column properties. For more information about 
modifying column properties, see Chapter 3. 

one section only. The Insert new columns in setting under 
the File Properties command controls this feature. The 
All sections setting (default) adds columns to all sections in 
the view. See "Inserting Columns in One or All Sections" later 
in this chapter. 

Item sorting Specify how you want to sort the items in the current 
section. (See Chapter 15.) 

Section statistics Press space bar to display the number of items 
in the current section. This is useful if you have a large number of 
tasks as items and you need to track how many there are. 

Select numeric functions Select what calculations to display if the 
section contains a numeric column. (See Chapter 8.) This setting 
displays only if the section contains a numeric column. 

Fi Iter Specify the categories for filtering the information in the cur¬ 
rent section. (See Chapter 11.) 


Removing Sections from a View 


You can remove a section (including its columns) from a view, but 
keep the categories in your file. You might do this if you no longer 
want to display low priority items in a view listing your priorities, 
but you still want these items to be assigned to that category in your 
file. 

When you remove a section from a view, the items are still assigned 
to the category used as the section head. The category remains in the 
category hierarchy and you can display it in other views. Also, any 
categories used as column entries in the section you remove remain 
in the category hierarchy. 

To remove a section from a view: 

1. Highlight the section head of the section you want to remove and 
Agenda asks you if you want to remove the section from the 
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2. Press enter to confirm that you want to remove the section. 
Agenda removes the section head, its assigned items, and any col¬ 
umns in the section from the current view. The categories that were 
used as the section head and column entries remain in your file. 

You can also remove a section from a view in the following ways: 

• Place the highlight anywhere in the section that you want to 
remove, press Fio (MENU), and select View Section Remove. 

• Use the View Properties command. (See Chapter 9.) 

If you remove all of the sections in a view. Agenda asks you if you 
want to discard the view. If you discard the view, Agenda displays 
another view. If you choose not to discard the view. Agenda displays 
the View Properties box. Specify the section(s) to include in the new 
view and press ENTER. 

Note If you remove a section by mistake, you can easily put it back 
in the view by following any of the procedures for adding 
sections. See "Adding Sections" earlier in this chapter. 


Moving Sections in a View 


You can change the position of sections in a view to make the view 
more meaningful. For example, you might have several sections in a 
view, each of which identifies a type of activity. You can rearrange 
the sections within the view to display these activities in the order in 
which you routinely perform them. 

Moving sections affects the current view only. It does not change the 
order of the categories in the category hierarchy or in other views. 

To move sections in a view: 

1. Do one of the following: 

• Highlight the section head and press ALT-Flo (MOVE). 

• Place the highlight anywhere in the section that you want to 
move, press PIO (MENU) and select View Section Move. 

Agenda collapses all of the sections in the view and displays a 
section symbol (§) adjacent to the collapsed sectionfe). 
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2. Press T or 1 to move the highlighted section head to where you 
want it and press ENTER. 

Agenda moves the section head and expands all sections in the view. 
Tip You can use the Section sorting setting in the View Properties 
box to sort sections by category, alphabetically, or 
numerically. 


Moving to a You can quickly highlight a specific section in a view. You might 

Specific Section want to do this if you're working in a view with many sections. 

in a View 

To move to a specific section: 

1. Press ALT-F5 (GO TO). 

Agenda lists the section heads in the current view. 

2. Highlight the section head you want to move to and press ENTER. 
Agenda highlights the section head you specify. 


Collapsing ar 
Expanding 
Sections in a 
View 


You can collapse one or more sections in a view to display only sec¬ 
tion heads. If your view contains many sections (such as Calls, Meet¬ 
ings, Correspondence, Issues, and so forth in a view of Activities), 
collapsing sections makes it easier to see all sections in the view at a 
glance. Also, collapsing the sections makes it easier to add or remove 
sections from a view. 


Figure 5-4 shows a view with three sections and each of their 
assigned items. Figure 5-5 shows the same view with all three 
sections collapsed. 
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To expand one or all collapsed section(s) in a view and redisplay the 

1. Highlight the collapsed section you want to expand. 

2. Do one of the following: 

• Press alt- = (hold down ALT and press equals) to expand the 
current section. 

• Press ALT- = twice to expand all sections in the view. 

Agenda redisplays the items assigned to the section(s) and removes 
the section symbol (§). 


Inserting Lines Between Sections 


You can separate the sections in a view with lines. The lines make it 
easier to distinguish each section and allow you to display more 
information on the screen. 

To insert lines between sections: 

1. Press Flo (MENU) and select View Properties. 

Agenda displays the View Properties box. 

2. Highlight Section separators, select Yes, and press ENTER. 
Agenda displays lines (section separators) between the sections of the 
view (Figure 5-6). 
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2. Highlight Hide empty sections, select Yes, and press enter. 
Agenda hides any empty sections in the view and displays 
[Hide empty] next to the view name. 

To redisplay empty sections: 

• Select No for the Hide empty sections setting in the View 
Properties box. 

Tip You can use the accelerator key ALT-v to hide or display empty 
sections. 


Hiding Repeating Column Heads 


A view containing many sections with the same column heads can 
become cluttered because the column heads repeat in every section. 
To make it easier to read your information, you can display the col¬ 
umn heads once only at tire head of the column in the first section. 
For example. Figure 5-8 shows a view in which the column heads 
repeat in every'section. 
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Figure 5-13 Replacing the Priority category with the 
Company category 

The Priority family and its assignments remain in the file but they 
don't display in the view anymore. 

To replace a category used as a section head or column head: 

1. Highlight the section head or column head to replace. 

2. Press F3 (choices) and do one of the following: 

• Highlight a category and press ENTER to select an existing 
category. 

• Type a new category name and press enter. 

If you replace a section head. Agenda displays the category you select 
and any items assigned to it. If you replace a column head. Agenda 
displays the category and any child categories. 
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Editing Category Names 


You can edit a category name to give a category a more descriptive 
title. You can edit category names in a view or in the category 
hierarchy. When you edit a category name, the new name replaces 
the original name throughout the file. 

Note Editing a category name is different from replacing one cate¬ 
gory with another. See "Replacing Categories" earlier in this 

To edit a category name: 

1. In a view or the category hierarchy, highlight the category whose 
name you want to edit. 

Agenda displays the current category name in the upper left 

3. Edit the category name. You can clear the existing name by 
pressing CTRL-ENTER. 

Agenda replaces the category name with the edited name. The new 
name appears wherever that category appears. 


Specifying Shorter Category Names 


If a column is narrower than the column entry. Agenda displays as 
much of the name as fits. To prevent this, you can give the category a 
short name. A short name is a substitute name for a category. If the 
category name doesn't fit in the column. Agenda displays the short 


For example, if you display the People category in a column that is 
too narrow to fit the word People, you can specify a shorter name 
that fits such as Who. 

To specify a short category name: 

1. Highlight the category whose name you want to shorten. 

2. Press Fio (MENU) and select Category Properties. 
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3. Highlight Short name and type a category name. 

4. Press enter twice to return to the view. 

Agenda displays the short name if the column is narrower than th 
category name. 


Moving Columns 


You can rearrange the columns in a view, including the column of 
items. Moving columns affects the current view only. It does not 
change the position of columns in other views or the order of the 
categories in the category hierarchy. 

To move columns: 

1. Do one of the following: 

• Place the highlight anywhere in the column that you want to 
move, press fio (MENU), and select View Column Move. 

• Highlight the column head for the column you want to move 
and press ALT-F10 (MOVE). 

2. Press <- or -»to move the column. The column changes position 
as you press either of these keys. 

3. Press enter to move the column to its new position. 

Agenda displays the column where you placed it. 


Note Agenda moves the column in the current section only, even if 
the column displays in all sections in the view. 


Tip There are two ways to move linked columns that display in 
more than one section See "Linking and Unlinking Columns" 
later in this chapter. You can remove the column (highlight the 
column head and press DEL) and then add it where you want it 
to appear. You can also rearrange the order of the columns 
using the Columns setting in the Section Properties box. 
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Adjusting Column Widths 


You can adjust column widths in a view to show the information you 
need. For example, you can widen a column that is too narrow to 
show long category names or a date and time format. The number of 
columns that you can display depends on the width of the columns; 
the narrower the columns, the more you can fit in a view. 

To adjust the width of a column: 

1. Highlight the section head or the column head above the column 

2. Press no (MENU) and select View Column Width. 

Agenda displays the current column width in the upper left 
comer of the screen and lets you enter a different width. 

3. Do one of the following: 

• Type a new column width. The item column can have a width 
from 5 through 77 characters. All other columns can have a 
width between 1 and 76 characters. 


I 


• Use <- and -> to adjust the column width one character at a 
time. <- decreases the column width; -» increases it. 

• Press SHIFT-? and Agenda automatically adjusts the width to 
fit the widest entry in the column. 

4. Press enter to accept the new column width. 

Agenda displays the column with the width you specify. 

Tip You can also specify the column width using the Width setting 
in the Column Properties box. 


Inserting Columns in One or All Sections 


When you add a column to a view you can place it in all sections or in 
one section only. If you want to display the same category assign¬ 
ments for each section (Figure 5-15), you add a column in all sections. 
If you want to display separate category assignments for each section 
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To specify where you want to insert columns: 

1. In a view, press Fio (menu) and select File Properties. 

2. Highlight Insert new columns in. 

3. Do one of the following: 

• Select All sections and press enter to add columns to all sec- 

Agenda adds columns according to the setting you specify. 

You can also specify whether to add a column in all sections or only 
to the current section when you add a new column. Use the View 
Column Add command and change the Insert in setting. 

For example, if you generally insert new columns in all sections (the 
default setting in the File Properties box), but want to add a column 
to the current section only, be sure to specify this in the Column Add 
box. The Insert in setting in the Column Add box overrides the 
Insert new columns in setting in the File Properties box. 

(See Chapter 3.) 


Linking and Unlinking Columns 


If you add a column in all sections, Agenda treats the column as a 
unit. If you replace the column head or change the width or format 
of the column, that change appears in each section of the view. 
Agenda links columns together, which means that you can adjust the 
whole column at once instead of section by section. 

If you add a column in one section and then add a column with the 
same column head in another section, those columns are not linked to 
each other. If you replace the column head, or change the width or 
format of each column, the change appears only in the current sec¬ 
tion. The columns are unlinked. 

You can unlink a column in one section from the same column in the 
other sections in the view. You can also link all the unlinked columns 
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Figure 5-18 View with linked columns 



Changing Column Formats 


When you add a column to a view, you can specify a category type 
and column format. The format controls how Agenda displays the 
assignments of the items and categories (for standard categories) or 
the dates and numbers (for date and numeric categories). You can 
change a column's format if you want to display category assign¬ 
ments differently. 

You can choose the format for a column when you add the column or 
you can modify the format later. 

To change the column format: 

1. Highlight the column head for the column that you want to 

2. Press Fio (menu) and select View Column Properties. 

Agenda displays the Column Properties box. The format choices 
depend on what type of category you highlight. The formats for 
standard categories are described in the following section. Date 
formats are described in Chapter 6. Numeric formats are 
described in Chapter 8. 
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3. Select the format settings you want to use, and press enter. 
Agenda displays the column in the format you select. 


Working with Standard Column Formats 


Different column formats let you display the assignment of an item to 
a category in different ways. You can select from the following for¬ 
mats for standard categories: 

• Name only 

• ParenfcCategory 

• Ancestor 


• Yes/No 

• Category note 

In Figure 5-19, the assignment of the item "Contact Tom about the 
meeting" to the Tom category displays in different column formats. 
Figure 5-20 shows the category relationships for the categories in Fig¬ 
ure 5-19. In this example, the Tom category is a child of the Sales 
category. Sales, in turn, is a child of the Staff category. Staff is a 
parent of Sales and is also Tom's ancestor (a category at a higher level 
in the category hierarchy within the same family). For more informa- 
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You can assign an item to a category by entering a category in a 
ParenfcCategory column. If you type an item containing tile existing 
category name. Agenda displays the assignment in 
ParenfcCategory format. 


An Ancestor column format displays an ancestor of the category to 
which the adjacent item is assigned. An ancestor is a category at a 
higher level in the category hierarchy within the same family. (See 
Chapter 16.) Specifically, the Ancestor format displays the ancestor 
that is also the immediate child of the category used as the column 

You might use Ancestor column format to display general informa¬ 
tion about an item's assignment. For example, you can show the 
name of a department associated with an item, rather than the person 
responsible for that item. 

In Figure 5-25, the Ancestor format displays the assignment of the 
item "Contact Tom about the meeting" to the Tom category (whose 
ancestor is the Sales category). 
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Figure 5-25 Ancestor fonnat 


In Figure 5-26, the Sales category is an ancestor of the Tom category. 
Sales is also the immediate child of Staff, the category used as the 
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Assigning items in Yes/No columns 

If you type an item containing an existing category name. Agenda 
displays the assignment in Yes/No format. 

To make an explicit assignment of an item to a category in Yes/No 

1. Place the highlight in the column adjacent to the item. 

2. Type Y to assign the adjacent item to the category used as the 

Agenda displays a Y in the column beside the item. This item is now 
assigned to the category you select. 

To unassign the item to the category: 

• Highlight the Y in the column adjacent to the item and type N. 

Assigning items to child categories in Yes/No columns 

When the column head is a parent category, you can assign the item 
to a child (or a descendent) of that category, rather than to the parent 
category itself. 

To assign an item to a child or descendent of a category: 

1. Place the highlight in the column adjacent to the item. 

2. Do one of the following: 

• Type the name of a new or existing category. If the category 
name begins with Y or N, type another letter first, press 
backspace, then type the category name. 

• Press F3 (CHOICES) to display the category hierarchy for the 
family of the column head. Highlight a category and press 
SPACE BAR to assign the adjacent item to that category. 

Agenda displays a Y in the column adjacent to the item. This item is 
now assigned to the category you selected. If you entered a new 
category. Agenda makes it a child of the category used as the column 




r erson's telephone number. Figure 5-30 shows the: 
; Tom category. 
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Example: Creating a Phone List 

To create a phone list, you create two columns: a column with Name 
only format and a column with Category note format to display the 
notes attached to the categories in the Name only column. 

Tip IPs often useful to display a Name only column beside a 
Category note column, though it isn't necessary to do so. 

The following procedure refers to the example in Figure 5-29. 

To create a phone list using a Category note column: 

1. Press Fio (menu) and select View Column Add. 

Agenda displays the Column Add box. 

2. Specify both of the following settings: 

• For Column head, specify an existing category whose chil¬ 
dren (or descendents) you want to display (for example. 
Staff). The category must be a standard category. 

• For Format, select Name only. 

Agenda displays the column headed by the category you specify. 
4. Attach a note to each category for which you want to display 


Each note should have the same kind of information or 
lar line, because the Category note column displays the 


For example. Figure 5-30, shows a person's telephone number as 
the first line of the note. 
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7. Specify all of the following settings: 

• For Column head, specify the same category for the column 
head in the Name only column (for example. Staff). 

• For Format, select Category note. 

• For Line number (which displays when you select Category 
note for the Format setting), specify the line from the note that 
you want to display (for example, 1, the default). 

• For Column title, specify the title of the Category note col¬ 
umn. The title is not a category and does not display in the 
category hierarchy. 

Agenda displays a column with the notes attached to each of the 
categories in the Name only column (Figure 5-29). 

Note If you type text in a Category note column. Agenda puts it in 
the correct line of the category note. 


Chapter 6 

Working with Dates and Times 


You can keep track of dates and times in Agenda. Agenda provides 
three built-in date categories to help you keep track of when you 
enter items, when you must attend to items, and when you complete 
the tasks described in items. Agenda also lets you create other date 
categories. 

You can either enter dates manually, in a column beside an item, or 
you can let Agenda enter the date in a column automatically, based 
on the text of the item (for example, "Call Len tomorrow"). You can 

"11/7/90”) or using words (for example, "tomorrow" or "next 
Wednesday”). 


In this Chapter 


This chapter describes how to 

• Use the three date categories that Agenda provides (Entry, When, 
and Done) 

• Specify dates and times 

• Enter dates in date columns 

• Use the pop-up calendar 


• Modify individual date columns 

Chapter 7, More about Dates and Times, provides additional infor¬ 
mation about working with dates and times, including how to create 
new date categories and how to specify the way that Agenda assigns, 




Working with Dates and Times 


Chapter 10, Managing Your Schedule, describes how to create 
datebook views to schedule appointments and how to set alarms to 
remind you when items need your attention. 


About Dates and Date Categories 


You use date columns to display dates in a view. You head date col¬ 
umns with date categories. The entries in date columns contain date 
and time values (Figure 6-1). 
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4. Type the When date that you want to assign to the item and 


Agenda assigns the When date to the item. For information about 
how to specify a date, see "Specifying Dates and Times" later in this 

If the view contains a When date column. Agenda displays die When 
date in the When date column beside the item. 


Assigning When 
Dates from the 
Text of an Item 


Agenda assigns a When date automatically from a date in the text of 
an item. When you enter an item that includes a date. Agenda inter¬ 
prets the date as the When date. Agenda also displays the date in a 
When date column if the view has a When date column (Figure 6-5). 
If the text of an item has more than one date. Agenda uses the first 
date as the When date. 





Each of the following items includes a date that Agenda can interpret 
as a When date: 

• Call Toni on August 7 

• Cheryl arrives tomorrow 

• Status report due first Wednesday in November 

• Contact Phil about meeting 3 hours from now 

• Call Marketing this Tuesday at 3:00 

You can turn off automatic dating of items if you do not want Agenda 
to assign When dates based on dates in die text of items. For exam¬ 
ple, you might want to turn off automatic dating of items if you use 
items to list bibliographical references such as "The News Review, 
Vol. 2, No. 3, November 7,1990". 

You can also assign When dates from dates in the text of notes instead 
of items. For more information about how Agenda automatically 
assigns When dates, see Chapter 7. 













Specifying Dates and Times 


Agenda lets you specify dates and times in many different ways. You 
can specify dates and times together, only dates, or only times. 
Whether you include a date in an item or enter a date in a column, 
you can specify dates in either of two ways: 

• Using traditional calendar notation (for example, "11/1/90") 

• Using words (for example, ’’the first of November" or "tomorrow”) 
Similarly, you can specify times in either of two ways: 

• Using actual times (for example, "2:00 pm") 

• Using words (for example, "three hours from now”) 

The following are valid entries in a date column: 

• Thursday at 3:30 pm 

• November 20,1990 

• Every Monday at 9 am 

• 3 hours from now 

• 4:00 

• Next April 

The following two sections, "Specifying Dates" and "Specifying 
Times," give additional examples of how to specify dates and times. 
You can specify dates using an absolute date or a relative date. An 
absolute date does not depend on the system date (for example, 
"November 1,1990"). A relative date does depend on the system date 
(for example. Agenda uses the system date to calculate the date for 
"next Monday"). 

You can also specify dates using a recurring date. A recurring date is 
a date that occurs regularly (for example, "every Monday"). 
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Agenda accepts dates between January 1, 1 A.D. and December 31, 
5000. If you enter a date that Agenda doesn't recognize, one of two 
things happens: 

• If the date is included in the text of an item. Agenda does not 
assign a When date to the item. 

• If the date is in a date column or if you assign the date using 
ALT-F2 (WHEN), Agenda tells you to enter the date again. 

Press any key to clear the message and enter the date in the correct 


Note Agenda lets you customize the way you specify dates and 
times. For example, by default Agenda recognizes the slash 
(/) as the separator when you enter dates (for example, 
11/20/90). However, you can choose to enter all dates using 
a different separator character (for example, 11-20-90). For 
information about customizing the way you enter dates and 

Specifying Dates The following table lists examples of some of the words and expres¬ 
sions that you can use to enter dates. 


Acceptable date phrases Example 


first through thirty-first 


yesterday, ystday 
day(s), week(s), month(s) 

in a fortnight 


the first of November 
November 23rd 

(day after current system date) 

(day before current system date) 

1 day ago, two weeks ago, 4 months ago 

this quarter 

(14 days from today) 

one week from today, the day after tomorrow, 

the day before yesterday 

the second of the month, the Fourth of July, in 
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Acceptable date phrases 


beginning, beg, end 


Example 

each Thursday, every month 

every other Monday 

this week, this month, this year 

in five working days 


Guidelines for Use the following guidelines when specifying dates: 

Specifying Dates 

• You can specify dates in calendar notation using numbers to rep¬ 
resent the month, day, and year (11/12/90), or an abbreviation to 
represent the month (Nov/12/1990). 

Agenda interprets the numbers you enter to represent the month, 
day, and year in a specific order. By default. Agenda assumes the 
first number is the month, the second is the day, and the third is 
the year (for example. Agenda interprets 11/1/90 as November 1, 
1990). However, you can change the way Agenda interprets cal¬ 
endar dates using the Number order setting. (See Chapter 7.) 

• You can specify dates using uppercase or lowercase letters. 

You can enter months or days of the week in uppercase (JUNE 24), 
with initial capital letters (March 10), or in lowercase (thursday). 

• You can use the first three letters of the word as an abbreviation 
(Fri). 

• You can specify periods of time using numbers or words. 

For example, you can specify either "in 2 weeks" or "in two 

• If you don't specify a year. Agenda assigns a year to the item that 
puts the date in the future. 

For example, if you enter "November 1" when the current date is 
October 8, Agenda assumes that you mean the coming November 
1 (one month from October 1), and assigns the item a date with 



fig with Dates and Times 


Specifying Times The following table lists examples of the words and expressions you 






(current system date and time) 
(8:00 am appended to date) 
(12:00 pm appended to date) 
(2:00 pm appended to date) 
(5:00 pm appended to date) 


tonight, tonite (5:00 pm appended to date) 

minute(s), min(s), hour(s), in 45 mins, in 2 hrs 


one hour from now 
in 3 hours 

Friday at 3:00 pm, @ 3pm 


By default. Agenda uses the times shown in the preceding table for 
the words morning, afternoon, evening, and tonight. You can, how¬ 
ever, specify different times for Agenda to display in a date column 
when you use these words in the text of an item. (See Chapter 7.) 


Guidelines for 
Specifying Times 


Use the following guidelines when specifying times: 


• You can specify times using actual times (3:00 pm) or words 
three hours). 

• You can specify times with dates of you can specify times alo: 
(If you specify a time alone. Agenda automatically gives it toe 


• You can enter times using a 12-hour or 24-hour clock. 

By default. Agenda uses a 12-hour clock to interpret time entries 
in a date column. If you don't specify am or pm. Agenda inter¬ 
prets the time as occurring between 8:00 am and 7:59 pm. For 
example, if you specify the time 3:30, Agenda interprets it as 3:30 
pm. However, you can set Agenda to use a different range, or to 
use a 24-hour clock. For more information about how Agenda 
interprets date and time entries, see Chapter 7. 
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You can specify periods of time using numbers or words. For 
example, you can specify either "in 6 hours" or "in six hours". 


Entering Dates in Date Columns 


You can enter dates in a date column in a view. You can also change 
dates in a column to reflect changes in your schedule. Entering dates 
in a date column is similar to entering categories in a column headed 
by a standard category. (See Chapter 3.) Recall, however, that the 
dates and times you enter in date columns are values, not categories. 
To enter dates in a column: 

1. Highlight the position in the date column across from the item 
for which you want to enter a date. 

2. Do one of the following: 

• Type the date that you want for that item and press ENTER. 
Agenda displays the date prompt at the top left comer of the 
screen as you start to type the date. 

If you type a date that isn't valid (for example, February 30, 
1991), Agenda tells you to enter the date again. Press any key 
to continue and re-enter a valid date. 

• Select a date from the pop-up calendar. The pop-up calendar 
is described in the following section. 

Agenda displays the new date in the date column and assigns the 
date to the item. 


Using the Pop-up Calendar 


You can display a pop-up monthly calendar for reference, or you can 
select a date from the pop-up calendar to insert in a date column 
(Figure 6-9). If you display the pop-up calendar when the highlight is 
on a date in a date column. Agenda displays the pop-up calendar for 
that month and highlights the date in that column. 
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Selecting a Date To select a date from the pop-up calendar: 

from the Pop-up 
Calendar 

1. Highlight the column entry position in a date column where you 
want to insert a date. 

2. Press F3 (CHOICES) to display the pop-up calendar. 

3. Highlight a date in the pop-up calendar. Use the keys described 
in the preceding section to move back and forth between differ¬ 
ent days, weeks, months, and years. 


4. Press enter to accept the date. 

Agenda displays the date you select in the column. 
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Selecting a Time 
from the Pop-up 
Calendar 


You can also use the pop-up calendar to select a time to display in the 
date column. To select a time to display with the highlighted date: 


1. Highlight the position in a date column where you want to insert 
a date and time. 

2. Press F3 (CHOICES) to display the pop-up calendar. 

3. Highlight a date in the pop-up calendar. Use the keys described 
in the section, "Browsing Through the Pop-up Calendar”, to 
move back and forth between different days, weeks, months, and 


4. Press F6 (settime). 

Agenda displays the Set Time box. 


As you type the time. Agenda displays what you type in the 
upper left corner of the screen. When you press enter twice, 
Agenda returns you to the pop-up calendar. 

6. Press enter to accept the date. 

Agenda displays the date and time you select in the column. 


Moving Quickly to 
Another Date 
in the Pop-up 
Calendar 


You can use the keys described in the table in the section "Browsing 
Through the Pop-up Calendar" to move back and forth in the pop-up 
calendar. However, if you want to quickly move the highlight to a 
specific date. Agenda provides a way to jump to that date in the 
pop-up calendar. 

From the pop-up calendar, do the following: 

1. Type the date to which you want to move. 


As you type the date. Agenda displays what you type in the 
upper left comer of the screen. 

2. Press ENTER. 


Agenda displays the pop-up calendar for the month you specify and 
highlights the date you specify. 
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You can add a date column to a view to display dates. You can head 
the date column with: 

• One of the built-in date categories (Entry, When, or Done) 

• An existing date category that you created 

• A new date category that you create when you add the column 
Note To use an existing standard category to head a date column, 

first convert the category to a date category. Converting a 
standard category may involve several extra steps. For more 
information about converting a standard category, see 
Chapter 7. After you convert the category to a date category, 
you can use the date category as the column head. 

To add a date column to a view: 

1. Place the highlight in the section or column adjacent to where 
you want to add a date column. 

2. Press Fio (menu) and select View Column Add. 

Agenda displays the Column Add box. 

3. Type the name of the date category that you want to use as a 
column head and press ENTER. If you specify the name of an 
existing date category, proceed to Step 5. 

If you specify the name of an existing date category, Agenda 
displays the Date Column Properties settings (Figure 6-10). 

4. If you specify the name of a new category as the column head, do 
both of the following: 

• Highlight Category type and press F3 (CHOICES). 

• Choose Date and press ENTER. 

Agenda displays the Date Column Properties settings 
(Figure 6-10). 

5. Complete the Date Column Properties settings and press enter. 
The settings are described in "Date Column Properties Settings" 
later in this chapter. 






Date ColUmn _ You use the Date Column Properties settings to control how Agenda 
Properties SettingS displays dates in individual columns. 

The phrase "Global defaults" (in the Column Add box) indicates that 
the global date column properties apply to the date column (Figure 
6-11). If you change one of the settings, the "Global defaults" phrase 
changes to "Local settings", indicating that Agenda no longer uses the 
global defaults for this column. 

As you change settings, the formatted sample at the bottom of the 
box changes to let you see how your selections will look. This gives 
you the chance to see how formats look before you complete the box. 
Note In most cases, you can simply accept the defaults for these 

settings. Check the formatted sample and if the date displays 
as you want it to, simply press enter to accept the box with¬ 
out changing any settings. 


How dates display in c 



Figure 6-11 The Date Column Properties settings 

Display date and/or time Specify whether Agenda displays the 
date and/or time and in what order. 




6-20 Working with Dates 




Date time (default) Agenda displays both 11/13/90 3:25pm 
the date and the time. 

Date only Agenda displays the 11/13/90 

date but not the time. 

Time date Agenda displays both 3:25pm 11/13/90 

the time and the date. 

The time appears 
before the date. 

Time only Agenda displays the 3:25pm 

_time but not the date._ 


If you decide to display the time (by choosing Date time. Time date, 
or Time only). Agenda displays the Clock, Show am/pm, and Time 
separator settings. 

Show day of week Specify whether to display the day of the week 
next to die date and/or the time. The choices are No (default) and 
Yes. 

Date format Specify the date format to display in a date column. 
The following table shows the choices for this setting. In this table, a 
blank space is used as the separator between elements (month, day, 
and year) of the date. The default separator is a slash (/). 


Date format 

MMDDYY (default) 

MMDDYYYY 

DDMMYY 

DDMMYYYY 

YYMMDD 

YYYYMMDD 

YYDDMM 


Example 


13111990 


19901113 
9013 11 




ods between the day, month, and year (7.11.90). 

Clock Specify whether Agenda displays times using a 12-hour clock 
or a 24-hour clock. The choices are 12 hr (default) and 24 hr. 

Agenda displays the Clock setting if you choose Date time. Time 
date, or Time only for Display date and/or time. 

Show am/pm Specify whether Agenda displays am and pm beside 
times. The choices are Yes (default), which displays times with am or 
pm (for example, 7:00pm), and No. 

Agenda displays the Show am/pm setting if you choose 12 hr for 
Clock. 
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Time separator Specify the separator Agenda uses between hours 
and minutes when it displays times. The choices are colon (:) 
(default), and hm (hour, minutes). 

For example, a time using the default displays as 3:30. If you choose 
hm, the time displays as 3h30m. 

Agenda displays the Time separator setting if you choose Date time, 
Time date, or Time only for Display date and/or time. 

Shortcut to Adding You can add a date column to a view using the accelerator keys ALT-L 
Date Columns (left) or ALT-R (right) and then selecting the name of an existing date 

category to head the column. For more information about using 
accelerator keys to add a column to a view, see Chapter 3. If you 
want to modify the format in which the dates display in the date 
column, use the View Column Properties command, described in the 
following section. 


Modifying Individual Date Columns 


You can modify the format of an existing date column to display the 
dates differently. For example, you may want to display only dates 
in a column that currently displays the time with the date. 

To specify or modify the properties for an existing date column: 

1. Highlight any entry in the date column that you want to modify. 

2. Press Flo (MENU) and select View Column Properties. 

Agenda displays the Column Properties box with the Date Col¬ 
umn Properties settings appended (Figure 6-12). 

The settings in the Column Properties box apply to all column 
types, not just date columns. For information about these set¬ 
tings, see Chapter 3. For information about the remaining 
settings, see "Date Column Properties Settings" earlier in this 






Chapter 7 

More about Dates and Times 


Chapter 6 shows you how to work with the three built-in date catego¬ 
ries, specify dates and times, add date columns, and enter and change 
dates in date columns. This chapter provides additional information 
about working with dates and times. 


In this Chapter 

This chapter describes 

• How to create date categories 

• How to convert a standard category to a date category 

• How Agenda interprets relative and recurring dates 

• How to globally specify the way that Agenda interprets and dis¬ 
plays dates and times 

You should read Chapter 6 before you read this chapter. 


Creating Date Categories 


Agenda provides three date categories that you can use to keep track 
of dates: Entry, When, and Done. You can also create your own date 
categories. The following examples show the types of things you can 
track with a date category that you create: 
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• The review history of a document 

• Different stages of completion of a project (for example, the date 
one employee finishes writing a proposal, the date the word pro¬ 
cessing department finishes typing it, and the date the proposal is 
back from the copy center and ready for distribution) 

• The date a bill is due and the date you actually pay the bill 

• The time a meeting ends. (For example, you might keep track of 
the start times for meetings with a When date category. If you 
want to keep track of the length of meetings to make sure you 
avoid double-booking yourself, you can create a date category to 
keep track of end times.) 

You can create a date category by adding a new date category or by 

converting a standard category to a date category. 


Adding a New Date Adding a date category is the same as adding any other category type 
Category to a file. For complete information about adding a category and the 

settings Agenda displays when you use the Category Add command, 
see Chapter 16. The steps that follow discuss only the settings that 
relate to adding a new date category. 

Caution Once you make a category a date category, you cannot 
change the category to another type. 

To add a new date category: 

1. Press Fio (MENU) and select Category Add. 

Agenda displays the Category Add box. Most of the settings in 
this box are described in Chapter 16. The settings under 
Advanced settings are described in "Specifying How Agenda 
Assigns Dates" later in this chapter. 

2. Highlight Category name, then type the name of the date cate¬ 
gory you want to add, and press enter. 

3. Highlight Type and press F3 (CHOICES). 

4. Choose Date and press ENTER. 

5. Complete the settings and press enter. 


Converting a You can convert a standard category to a date category. If yo 

Standard Category standard category to keep track of dates in an earlier release < 
to a Date Category Agenda, you may want to convert it to a date category. 





Before you convert a standard category to a date category, you need 
to know the following: 

• After you convert a standard category to a date category, you 
cannot change the category to another type. 

• When you convert a standard category to a date category, all col¬ 
umns headed by that category in all views become date columns. 

• You can not convert a standard category that has more than one 
level of children. To see the number of levels, press F9 (CAT MGR) 
to check the category hierarchy before you attempt to convert the 
category. 

• If the standard category has child categories. Agenda converts 
them to dates when the category is converted. If the children are 
valid date column entries, they are converted to date values. For 
example. Agenda can convert "November 20,1990” or "today”, but 
not "after the meeting". Agenda discards any child categories that 
it cannot convert to date values. 

To convert a standard category to a date category: 

1. Highlight the category you want to convert. 

2. Press Flo (MENU) and select Category Properties. 

Agenda displays the Category Properties box. 

3. Highlight Type and press F3 (choices). 

4. Choose Date and press ENTER twice. 

If the category has no assignments. Agenda converts the category 
to a date category. 

If the category has assignments. Agenda asks if you want to con¬ 
vert the category to a date category. 

5. Press ENTER to confirm that you want to convert the category. 

6. If Agenda warns you that some of the children can't be converted 
to date values, do one of the following: 

• Press any key to continue with the conversion. 

• Press ESC to cancel the conversion. 




i the category unless you pr 
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Advanced Settings You use the settings under Advanced settings in the Category Prop¬ 
erties box to control how Agenda assigns dates. 

The following two settings apply to all categories, not just date cate¬ 
gories, and are described elsewhere in this book. 

• If an assignment conflicts with another (Chapter 20) 

• Category is protected (Appendix G) 

Descriptions for settings that apply to date categories follow. 

Note The following settings have different defaults, depending on 
the date category you use (Entry, When, Done, or a category 
you create). In most cases, you can simply use the defaults for 
the three built-in date categories. If you create a new date 
category, however, you may want to select choices appropri¬ 
ate for the kind of date the category will track. You can select 
any choice for any date category, although certain choices are 
more appropriate for certain categories. 

Assign item date Specify how Agenda assigns dates. 





Agenda does not automatically assign the date. 

Agenda assigns the date based on the system date when 

Agenda assigns the date based on the system date when 
the item is entered and re-assigns the date each time the 


Agenda assigns the date based on the system date when 
the note is entered and re-assigns the date each time the 

Agenda assigns the date based on the system date when 
the item or note is entered and re-assigns the date each 
time the item or note is edited. 

Agenda assigns the date based on the system date when 
the item is entered and re-assigns the date if the item is 
assigned to another category. 

Agenda assigns the date based on the system date when 
the item is entered and re-assigns the date each time the 





example, a due date), you probably want Agenda to assign the 
date from the item (or note) text. 

Which one Specify which date Agenda uses when it finds more 
than one date in the item or note text. The default is 1, the first date 
finds. The choices are 1 through 10. 

You might want to specify something other than the default if you 
create a date category to keep track of end times of meetings and if 
your items include both the start and end times for the meetings. 
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In the item "Status meeting from 10:00 to 2:30", Agenda automatically 
assigns 10:00 as the When date. If you create a new date category. 
End, and set Which one to 2, Agenda assigns 2:30 to the End 
category. 

In the preceding example, the End category, together with the start 
time stored as a When date, helps you track the duration of events. 
You might find this useful if you create datebook views and want the 
length of meetings indicated in the view. (See Chapter 10.) 

Agenda displays the Which one setting if you choose From the item 
text. From the note text, or From the item or note text for Assign 
item date. 

Set the item date from Done key Specify whether Agenda assigns 
the current system date when you use F4 (DONE). The default for the 
Done date category is Yes. The default for all other date categories 
(Entry, When, and categories you create) is No. 

If you create a date category that is similar to the Done date category 
you might want to choose Yes for this setting. 

If you choose Yes, Agenda still assigns dates automatically based on 
your selection for the Assign item date setting. If you press F4 (doni 
to assign a date directly, however, that date overrides the one that 
Agenda automatically assigns. 

Set the Item date from When key Specify whether Agenda assigns 
a date when you use ALT-F2 (when). The default for the When date 
category is Yes. The default for all other date categories (Entry, 

Done, and categories you create) is No. 

If you create a date category that is similar to the When date category 
you might want to choose Yes for this setting. 

If you choose Yes, Agenda still assigns dates automatically based on 
the choice you select for the Assign item date setting. If you use 
ALT-F2 (WHEN) to assign a date directly, however, that date overrides 
the one that Agenda automatically assigns. 



I 
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remind Mary before the actual meeting date, you can use ALT-F2 
(WHEN) to assign the When date December 10 to the item, instead of 
December 13. 

Category can use recurring dates Specify whether Agenda treats 
dates that are associated with this date category as recurring dates. 


Yes Agenda treats dates that include the words "each" or 

"every" as recurring dates. For example, "every Tuesday" 
is treated as a recurring date. 

No Agenda does not treat dates that include the words "each" 

Tuesday" is interpreted as "Tuesday”. ? ^ 


The default for the When date category is Yes. The default for all 
other date categories is No. 

For more information on recurring dates, see "How Agenda Inter¬ 
prets Items with Recurring Dates" later in this chapter. 


How Agenda Interprets Relative Dates 


The following sections discuss how Agenda interprets relative dates 
in items and in date ranges. You specify dates in ranges when you 
filter a view (Chapter 11) and when you establish date conditions 
(Chapter 20). 

The following fable summarizes the differences in how Agenda inter 
prets relative dates in items and relative dates in ranges. 
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Agenda interprets relative dates Agenda interprets relative dates as belong- 
as being in the future (If today is ing to the current period, whether the date 
Wednesday, "Monday" is next is in the past or future (If today is 

Monday). Wednesday and you specify a date range of 

Monday through Friday, "Monday" is the 
past Monday, two days before 

_ Wednesday). _ 


How Agenda 
Interprets Relative 
Dates in Items 


Agenda interprets relative dates based on the current system date. 
Relative dates in items are fixed. If you enter the relative date "today" 
in an item. Agenda interprets it once. For example, if you enter 
"today" on March 15, the date for that item will always be March 15; it 
doesn't change when the system date changes. 


The hi 


wing rules outline how Agenda interprets relative dates in 


• The week starts on Monday and ends on Friday. 

For example, for the item "Call Sarah at the beginning of next 
week". Agenda gives the item Monday's date (the first day of the 
week). You can change what Agenda interprets as the beginning 
and the end of the week. For more information about how 
Agenda interprets the week, see "Specifying How Agenda Inter¬ 
prets and Displays Dates and Times" later in this chapter. 

• Agenda interprets dates in items as the next occurrence of the day 
specified. 

For example, if today is Tuesday, "Monday” is the date six days in 
the future. The exception to this is that Agenda interprets the day 
as the current day if you specify the day of the week correspond¬ 
ing to today. For example, if today is Wednesday, 11/7 and you 
enter "Wednesday" in an item. Agenda interprets the date as 11/7. 



If a date is preceded by "this". Agenda interprets the date as 
falling within the current time period. 

For example, if today is Wednesday, Agenda interprets "this 
Monday" as two days before the current date (that is, within the 
current week). Agenda interprets "this" preceding a time period 
as the start of the specified period. For example, "this week” is 
Monday; "this year" is January 1 of the current year. 

If a date is preceded by "next," Agenda interprets the date as 
falling within the following time period. 

For example, if today is Tuesday, Agenda interprets "next Thurs¬ 
day" as the date a week and two days from now. Agenda inter- 
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How Agenda 
Interprets Relative 
Dates in Ranges 


Agenda interprets relative dates in ranges differendy from relative 
dates in items. In general. Agenda interprets dates in ranges as 
belonging to the current time period whether the date is in the past or 
future. So, if today is Wednesday, Agenda interprets a date range of 
Monday to Friday as this week's Monday (two days ago) to this 
week's Friday (two days from today). 

This is different from how Agenda interprets Monday in an item. 
Agenda interprets dates in items as the next occurrence of the day 
specified, so Monday would be next Monday. 

Note Agenda reinterprets relative dates in date ranges each time 
the system date changes. So, if you use "today" as part of a 
date range. Agenda always interprets it as the current system 


Because Agenda reinterprets relative dates in ranges, you can estab¬ 
lish date conditions and date filters that always show you current 
information. For instance, you might establish a date filter with a 
range of Monday to Friday. For the week of November 12, this view 
shows you items with dates from Monday, November 12 through 
Friday November 16. On the following Monday (November 19), the 
date range would be reinterpreted to show items for the new week 
(November 19 - 23). 


If you want a date in a range to keep its original value (rather than 
being reinterpreted when the date changes), enter the date using 
calendar notation. You can also preface a relative date with a dollar 
sign; for example, "$Monday" tells Agenda to keep the original date 
even when it has passed. 


How Agenda Interprets Items with Recurring Dates 


You can keep track of events that occur regularly — for example, 
weekly meetings or monthly deadlines. If a date includes the words 
each or every, Agenda considers the item a recurring item. 

For example. Agenda displays the item "Status meeting every 
Monday" under the section for Monday, in all weekly datebook 
views. Although the item "Status meeting every Monday" shows up 
in every weekly datebook view. Agenda treats the item as one item. 
Thus, if you discard the item. Agenda discards the item from every 
section in which it appears. For information about datebook views, 
see Chapter 10. 
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The first date that Agenda assigns to the recurring item is considered 
the base date for the item. For example, if today is Thursday, 
November 8, and you enter the item "Status meeting every Monday", 
Agenda assigns the base date of Monday, November 12 to the item. 

If you designate a recurring item as done. Agenda does the following: 

• Designates the item as done with today's date as the Done date 

• Places the done symbol (!!) next to the item 

• Makes a duplicate of the original item 

• Gives the new item the next When date in the calendar 

For example, if today is Monday, November 12 and you designate the 
item "Status meeting every Monday" as done. Agenda creates a new 
item "Status meeting every Monday" with the base date of the follow¬ 
ing Monday, November 19. 


Specifying How Agenda Interprets and 
Displays Dates and Times 


Date properties determine how Agenda interprets and displays dates 
and times. You can select date properties from a view using: 

• Global properties 

Global properties determine the defaults for how Agenda inter¬ 
prets and displays dates and times in the current file. You set 
global properties for dates with the File Properties command. 

For more information about global date properties, see the follow- 

• Local properties 

Local date column properties override some of the global settings. 
You can select different properties for fhe way in which Agenda 
displays dales and times in a single column. You select date prop¬ 
erties for a single column with the View Column Properties 
command. 

For more information about local date column properties, see 
Chapter 6. 



Specifyjng When you select global properties for date columns. Agenda uses 

Properties for All them as the defaults for all date categories. The global properties 
Date ColUmns determine how Agenda interprets and displays dates. 

To specify global date properties: 

1. Press Fio (MENU) and select File Properties. 

Agenda displays the File Properties box. 

2. Highlight Global date settings and press SPACE BAR. 

Agenda displays the Global Date Settings box (Figure 7-2). The 
settings are described in the following section. 

3. Complete the settings and press ENTER twice. 



Figure 7-2 The Global Date Settings box 

Global Date You use the Global Date Settings to control how Agenda interprets 

Sett i n g S and displays dates. 


Note You do not need to enter and display dates in the same way. 
The Input format settings control how you enter dates (and 
how Agenda interprets the dates you enter). The Display 
format settings control how Agenda displays dates. For exam 
pie, you can decide to enter dates using a period as the 



More about Dates and Times 7-15 


When you enter "Morning" in a date column, the date column dis¬ 
plays the time (not the word) you specify here. For example, if you 
specify 10:00am for Morning and you enter the item "Call Bob in the 
morning". Agenda displays 10:00am in the date column. 

Note The Morning setting also specifies the time range Agenda 
uses if you don't specify am or pm with the time. If you 
accept the default of 8:00am, Agenda interprets times without 
am or pm as falling between 8:00 am and 7:59 pm. (For exam¬ 
ple, Agenda interprets "Meeting at 8:00" as 8:00 am.) If you 
change Morning to 9:00am, Agenda interprets times without 
am or pm as falling between 9:00 am and 8:59 pm. (For exam¬ 
ple, Agenda interprets "Meeting at 8:00" as 8:00 pm.) 
Afternoon Specify the time that Agenda displays in a date column 
when you include "afternoon" in the text of an item (or when you 
enter "afternoon” in the column). The default is 2:00pm. 


• Highlight Afternoon, type the time, and press ENTER. 

Evening Specify the time that Agenda displays in a date column 
when you include "evening" or "tonight" in the text of an item (or 
when you enter "evening" or "tonight" in the column). The default is 
5:00pm. For example, if you specify 9:00pm for Evening and you 
enter the item "Call Bob tonight". Agenda displays 9:00pm in the date 
column. 

To enter a time: 

• Highlight Evening, type the time, and press ENTER. 

Beginning of week Specify the day Agenda uses as the first day of 
the week. Agenda uses this day as a replacement in a date column 
for the phrases "beginning of week", "this week", and "next week". 
The default is Mon (Monday). 

End of week Specify the day Agenda uses as the last day of the 
week. Agenda uses this day as a replacement in a date column for 
the phrase "end of week". The default is Fri (Friday). 

First quarter Specify a month and day to use as the beginning of 
first fiscal quarter. Agenda uses this date as a replacement in a date 
column for the phrase "first quarter". The default is Jan 1. A quarter 
lasts three months, so the second quarter starts April 1 if you choose 
the default. 


3 between the month and the day. 



7-16 More about Dates and Tin 


If the highlight is on the month, you can press F3 (CHOICES) to display 
a list of all the months. 

If the highlight is on the day, type the day number you want and 
press ENTER. 

Beginning of year Specify a month and day to use as the first day 
of the year. The default is Jan 1. 

End of year Specify a month and day to use as the last day of the 
year. The default is Dec 31. 

Month alone means Specify a day of the month to display when 
you type just the name of the month without a specific date. 






First day (default) 


Agenda displays the first day of the month as the 
date. For example, if you choose First day and type 
'Attend conference next September" as the item. 
Agenda assigns "September 1" as the When date. 


Last day Agenda displays the last day of the month as the 

date. For example, if you choose Last day and type 
"Attend conference next September" as the item. 
Agenda assigns "September 30" as the When date. 

Nth day If you choose Nth day. Agenda displays the addi¬ 

tional setting Day #. 


Day # Specify a day to display when you type just the name of the 
month without a specific date. For example, if you choose 15 for Day 
# and type "Attend conference in September" as the item, Agenda 
assigns "September 15" as the When date. 


You can choose any number from 1 to 31. The default for Day # is 1. 
Agenda displays the Day # setting if you choose Nth day for Month 


Process Done items Specify how Agenda handles Done items. 
(See Chapter 13.) 


You use the Input format settings to control how Agenda interprets 
dates and times that you enter. 

Press SPACE BAR on Input format in the Global Date Settings box to 
display the Input Format box. 


Input Format 
Settings 



Number order Specify how Agenda interprets dates that you enter 
in calendar notation (for example, whether 2/3 is interpreted as 
March 2 or February 3). 


Omice 

If you enter 

Agenda interprets it as 

MDY (default) 

11/12/90 

November 12,1990 

MYD 

11/90/12 

November 12,1990 

DMY 

12/11/90 

November 12,1990 

DYM 

12/90/11 

November 12,1990 

YDM 

90/12/11 

November 12,1990 

YMD 

90/11/12 

November 12,1990 

Input date separator Specify the punctuation mark that Agenda 
interprets as the separator when you enter dates in a date column. 

The choices are slash (/) (default), hyphen (-), period (.), comma (,), 
and colon (:). For example, to enter dates using a period instead of a 
slash, (such as 11.12.90), choose the period as the separator. 

Input clock Specify whether Agenda interprets the times you enter 
using a 12-hour or a 24-hour clock. 

Choice 

Result 


12 hr (default) 

example^ if you enter 3:00, Agenda interprets the entry as 
3:00 pm. 


Agenda interprets time entries using a 24-hour clock. For 
example, if you enter 3:00, Agenda interprets the entry as 
3:00 in the morning. To specify 3:00 in the afternoon, you 
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Performing Simple Calculations 


You can perform simple calculations in Agenda such as totaling a col¬ 
umn of figures or averaging a column of expenses. To perform calcu¬ 
lations or track numbers, you create numeric columns. 


In this Chapter 


This chapter describes how to 

• Create a numeric column 

• Enter numbers in numeric columns 

• Change the properties of a numeric column 

• Add a numeric category to the category hierarchy 

• Convert a standard category to a numeric category 

• Customize a numeric column 


About Calculations 

Agenda lets you perform the following calculations on a column of 

• Minimum value 

• Maximum value 

8-1 





ilculations you want Age 
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Using a New You use a new category when you create a completely new numeric 

Category as the column — one that does not exist in any view in your file. This is the 

Column Head procedure you use most often when you want to create a numeric 


To add a numeric column to a view: 

1. Press Flo (MENU) and select View Column Add. 

Agenda displays the Column Add box. 

2. Highlight Column head, type the name of the category that you 
want to use as the column head, and press enter. 

3. Highlight Category type and press F3 (CHOICES). 

4. Choose Numeric and press enter. 

Agenda displays the Numeric Column Properties settings 
(Figure 8-2). The settings are described later in this chapter. 

5. Complete the settings and press enter. 

When you highlight the column head. Agenda displays a number 
symbol (#) in the upper right corner of the screen indicating that the 
column is numeric. The labels for the calculations you select with the 
Numeric Column Properties settings display at the bottom of the sec¬ 
tion or sections into which you insert the new column. 



Column Head 


To create a numeric column using an existing numeric 
column head: 

1. Press no (MENU) and select View Column Add. 
Agenda displays the Column Add box. 

2. Highlight Column head and do one of the followit 

• Type the name of the existing category that you 
as the column head and press enter. 

As you start to type. Agenda tries to match the i 
with an existing numeric category. 

• Press F3 (choices), choose an existing numeric c 
as a column head, and press enter. 

Agenda displays the Numeric Column Properti 
(Figure 8-2). The settings are described later in 



When you highlight the column head. Agenda displays a number 
symbol (#) in the upper right comer of the screen indicating that the 
column is numeric. The labels for the calculations you select using 
the Numeric Column Properties settings display at the bottom of the 
section or sections into which you insert the new column. 


Using a Standard You can use an existing standard category to head a numeric column 
Category as the and convert it to a numeric category. For information on changing a 

Column Head standard category to numeric, see "Working with Numeric Catego¬ 

ries" later in this chapter. 

Caution After you convert a category to a numeric category, you 
cannot convert the category to another type. 

To create a numeric column using a standard category as the column 


1 . Press Flo (MENU) and select View Column Add. 

Agenda displays the Column Add box. 

2. Highlight Column head and do one of the following: 

• Type the name of the existing standard category that you 
want to use as the column head and press enter. 

As you start to type. Agenda tries to match the category name 
with an existing standard category. 

• Press F3 (CHOICES), choose an existing standard category to 
use as a column head, and press ENTER. 

3. Highlight Category type and press F3 (CHOICES). 

4. Choose Numeric and press enter. 

If the standard category does not have child categories. Agenda 
converts the category to a numeric category and displays the 
Numeric Column Properties settings (Figure 8-2). The settings 
are described later in this chapter. 

If the standard category has child categories. Agenda asks if you 
want to convert the category to a numeric category. 

5. Press ENTER to confirm that you want to convert the category if 
Agenda asks you to. 




6. If Agenda warns you that some of the children cannot be con¬ 
verted to numeric values, do one of the following: 

• Press any key to continue with the conversion. 

Agenda displays the Numeric Column Properties settings 
(Figure 8-2). The settings are described in the following 


• Press esc to cancel the conversion. 

7. Complete the settings and press enter. 

When you highlight the column head. Agenda displays a number 
symbol (#) in the upper right comer of the screen indicating that the 
column is numeric. The labels for the calculations you select using 
the Numeric Column Properties settings display at the bottom of the 
section or sections into which you insert the new column. 


Numeric Column 
Properties Settings 


You use the Numeric Column Properties settings to specify the for¬ 
mat for the numbers in a numeric column and the calculations you 
want Agenda to perform on those numbers. The Formatted Samples 
at the bottom of the screen let you see how a positive and negative 
number display in the default format. These samples change if you 
select a different format. 


Label or currency symbol Choose the symbol you want to display 
beside the numbers. 


The choices are None (default), % (percent), $ (dollar), c (cent), 

£ (pound), and ¥ (yen). Agenda automatically places the symbol you 
select in the correct position (for example, it places $ to the left of 
numbers). 

Decimal places Specify the number of decimal places you want to 
display. The default is 2. 

Note If you enter a number with more decimal places than the cur¬ 
rent format displays. Agenda rounds off the extra decimal 
places. For example, if you enter 3.459 in a column that is 
formatted to display two decimal places. Agenda displays it 
as 3.46. When performing calculations. Agenda uses all the 
decimal places you enter for a number, even if it does not 
display them all. 

Use thousands separator Choose whether you want the number 
format to include a thousands separator (for example, the comma in 
3,000). The choices are No (default) and Yes. 
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Note To specify the characters used as decimal and thousands sep¬ 
arators, use the Utilities Customize settings described in 
"Customizing Numeric Formats” later in this chapter. 
Negative indicator Choose a character to indicate negative numbers. 
The choices are minus (-) (default) and parentheses (). 

Display % of total Choose whether you want an additional column 
next to the numeric column showing each number you enter as a 
percentage of the total amount entered. The choices are No (default) 


Note You cannot enter anything in a % of total column. Agenda 
calculates the percentages for you. 

The remaining settings let you choose the calculations you want 
Agenda to perform. The choices for each calculation are No and Yes. 
For Total, the default is Yes; for all the other calculations, the default 
is No. The following table describes these calculation settings. 






Average the numbers in the column Average 

Display the largest number entered in the column Maximum 


Entering Numbers and Displaying Results 


Once you create a numeric column, you can enter numbers in it. 
Entering numbers in a numeric column is like entering categories in a 
standard column. 


: column adjacent to the item for which you 


2. Type the number and press ENTER, T, or 1. 

3. Repeat Steps 1 and 2 for all the numbers you want to add to the 
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To change a number: 

• Type over the original number and press enter, T, or -l. 

Agenda displays the numbers in the format you specify, performs the 
calculations, and shows the results at the bottom of the numeric col¬ 
umn. Each time you enter a new number or change a number. 
Agenda recalculates the results. 

Guidelines for Use the following guidelines when you work with numeric 

Entering Numbers categories: 

There is no limit to the size of the numbers you can enter in a numeric 
column. 

Note If you plan to enter large numbers and you want to display 
them, use the View Column Width command to widen the 
numeric column. Agenda displays numbers that are larger 
than the column width in scientific notation. 

You cannot enter numbers that include non-numeric characters such 
as letters or symbols with two exceptions: 

• Numbers that include the specified label or currency symbol, 
thousands separator, or negative indicator. For example, if you 
specify $ as the currency symbol. Agenda accepts numbers 
preceded by a $ such as $23.00. 

• Numbers entered in scientific notation. Agenda accepts the fol¬ 
lowing format for scientific notation: 

3.22e+12 (represents the number 3,220,000,000,000) 


Assigning Items 
to Numeric 
Categories 


When you enter a number for an item in a numeric column, you 
assign the item to the numeric category used as the column head. 

The number you assign to the item is a numeric value, not a category. 
The number links the item to the numeric category used as a column 
head. For example, in Figure 8-3, the item "heat" in the Amount 
column is assigned to the Amount category with the value 120. 
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Figure 8-3 An item assigned to a numeric category 

Because the number is not a category, it does not appear in the 
category hierarchy. 


Working with Numeric Columns 


You can specify how Agenda displays numbers and performs calcu¬ 
lations in a numeric column using the Numeric Column Properties 
settings. You can also specify calculations for all the numeric 
columns in a section using the Section Properties settings. 

Changing Numeric You use the Numeric Column Properties settings to change the char- 
Column Properties acteristics of a numeric column. 

To display the Numeric Column Properties settings: 

1. Highlight the numeric column you want to change. 

2. Press Fio (MENU) and select View Column Properties. 

Agenda displays the Column Properties box. The settings are 
described in "Numeric Column Properties Settings" earlier in this 

3. Complete the settings and press ENTER. 




Specifying If you are working in a section that has several numeric columns, you 

Calculations for can specify how Agenda performs the calculalion(s) for all the 

all the Numeric columns. 

Columns in a 
Section 


To specify how Agenda performs calculations for all the numeric 


1. Highlight the section head and press F6 (Profs). 

Agenda displays the Section Properties box. 
ij, Highlight Select numeric functions and press space bar to dis¬ 
play the Select Numeric Functions box. The settings in the box 
are the same as the calculation settings in the Numeric Column 
Properties box described earlier in this chapter. 

3. Complete the settings and press enter. 

Agenda displays the calculation labels at the bottom of the section 
and the calculation results at the bottom of the numeric columns in 
the section. 

Tip Use the space bar to toggle the results off and on. 


Working with Numeric Categories 


When you create a numeric column using a new category as the col¬ 
umn head. Agenda automatically makes that new category a numeric 
category. You can also add numeric categories directly to the 
category hierarchy or convert a standard category to a numeric cate¬ 
gory. You cannot convert a numeric category to any other kind of 
category. 

Adding a Numeric You can add a numeric category to the category hierarchy while you 
Category are working in a view or in the category manager. 

To add a numeric category to the category hierarchy: 

1. Press Flo (MENU) and select Category Add. 

Agenda displays the Category Add box. 

2. Type the category name and press enter. 

3. Highlight Type and press F3 (CHOICES). 
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4. Choose Numeric and press ENTER. 

5. Complete the other settings and press enter. For an explanation 
of the settings in the Category Add box, see "Category Add/Ca¬ 
tegory Properties Settings" in Chapter 16. 

Agenda displays the new numeric category at the bottom of the cate¬ 
gory hierarchy. If you are working in a view, press F9 (CAT MGR) to 
display the new category in the category hierarchy. 

Converting a You can convert any standard category to a numeric category. 

Standard Category 
to Numeric 

Note Usually when you want to convert a numeric category, use 
the procedure in "Using a New Category as the Column 
Head” described earlier in this chapter. 

You convert a standard category used as a column head to a numeric 
category whenever you want to convert the column to a numeric 
column. For example, you might have a column headed by the stan¬ 
dard category. Forecast, that you use to keep track of projected sales 
of a group of products. Originally, you planned to enter categories 
that describe the prognosis for a product such as Excellent, Good, 
Poor. Later, you decide to enter the actual number of units you proj¬ 
ect will be sold. To enter the number of units, you need a numeric 
column. So, you convert Forecast to a numeric category. 

Guidelines for Use the following guidelines when you convert a standard category 

Converting to a numeric category. 

Standard 

Categories 


After you convert a category to a numeric category, you cannot 
convert the category to another type. 

You cannot convert a standard category that has more than one 
level of child categories. To see the number of levels, press F9 (CAT 
MGR) to check the category hierarchy before you attempt to con¬ 
vert the category. 

When you convert a standard category to a numeric category, any 
column headed by that category in any view becomes a numeric 

If a standard category has child categories. Agenda attempts to 
convert them to numbers when it converts the category. 
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Note If the child category names consist of numbers. Agenda con¬ 
verts the names to the same numbers. For example, a cate¬ 
gory called 112 is converted to the number 112. If the child 
category names consist of non-numeric text (for example, 
names like High, Medium, and Low) Agenda cannot mea¬ 
ningfully convert the names to numbers, so it converts them 
to zeros. Like all other numeric entries, the numbers 
produced by these conversions are not categories and do not 
display in the category hierarchy. These numbers are the val¬ 
ues of the assignment of items to the numeric category. 

To convert a standard category to a numeric category: 

1. Highlight the category you want to convert. 

2. Press F10 (MENU) and select Category Properties. 

Agenda displays the Category Properties box. For an explana¬ 
tion of the settings in the Category Add box, see "Category 
Add/Category Properties Settings" in Chapter 16. 

3. Highlight Type and press F3 (CHOICES). 

4. Choose Numeric and press enter twice. 

If the category has no assignments. Agenda converts the category 
to a numeric category. 

If the category has assignments. Agenda asks if you want to con¬ 
vert the category to a numeric category. 

If the category has non-numeric children. Agenda warns you that 
it cannot convert the values and will discard the children when it 
converts the category. 

5. Press ENTER to confirm that you want to convert the category if 
Agenda asks you to. 

6. If Agenda tells you that it cannot convert the values to numeric, 
do one of the following: 

• Press any key to continue with the conversion. 

• Press ESC to cancel the conversion. 

If the converted category is a column head, the column becomes a 
numeric column with the default format settings and the default cal¬ 
culation, Total. Agenda displays a number symbol (#) in the upper 
right comer of the screen. For instructions on changing format and 
calculations, see "Changing Numeric Column Properties" earlier in 
this chapter. 
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Customizing Numeric Formats 


You can specify the characters used as the decimal separator and the 
thousands separator using the Utilities Customize settings. 

To customize numeric formats: 

1. In a view, press Flo (menu) and select Utilities Customize. 
Agenda displays the Utilities Customize box. 

2. Do both of the following. 

• Highlight Decimal separator and press F3 (CHOICES). The 
choices are Dot (.) (default) and Comma (,). Choose the char¬ 
acter you want to use as the decimal separator and press 


• Highlight Thousands separator and press F3 (CHOICES). The 
choices are Comma (,) (default). Dot (.), and Space (). 

Choose the character you want to use as the thousands sepa¬ 
rator and press enter. 

You cannot use the same character as the decimal separator 
and the thousands separator. 

Agenda displays the view. 

You can turn the display of the thousands separator off and on using 
the Use thousands separator setting in the Numeric Column Proper¬ 
ties box. The decimal separator is always on. 



Chapter 9 

Working with Views 


You look at the information in your file through views. Views are 
similar to reports in a traditional database; each view displays the 
information that you choose. Views differ from reports, however, 
because you also use views to enter information into your Agenda 


In this Chapter 


This chapter describes how to 

• Switch from one view to another 

• Add and modify views 

• Select categories to display as section heads in views 

• Replace categories in views by specifying parents 

• Copy and delete existing views 

• Rearrange the list of views and sort them alphabetically 


About Views 


You can see different perspectives of your file by creating different 
views. For each view you can display different categories and their 
assigned items. For example, the Activities Planner application pro¬ 
vided with Agenda contains the views Calls, Today, People, and 
Priorities. Each view lets you look at the information in Activities 
Planner in a different way. 
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Switching from One View to Another 


You can switch between different views in your file. To do this, you 
select the view from the view manager. 

To switch between views within a file: 

1. In a view, press FS(vw MGR). 

Agenda displays a list of views in the view manager (Figure 9-4). 
If the list contains many views, press PGUP or PGDN to display 


2. Highlight or type the name of the view that you want to work 


If you type an existing view name. Agenda highlights that name 
in the list. 

3. Press enter to display the view you select. 


Shortcuts to Switching Views 

In a view, you can use the following keys to select other views. 

If you want Agenda to display _ p ress 

The last view (of two views most recently displayed) alt-F8 (last 
Jh e next view in the list of views (cycle forward through alt-n 

The previous view in the list of views (cycle back through alt-p 
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Agenda displays the View Add box. The settings are described 
in "View Add/View Properties Settings" later in this chapter. 

2. Type a name for the view and press enter. 

3. Highlight Sections. 

4. Press F3 (choices) and highlight a parent category such as Com¬ 
pany whose child categories you want to display. 

5. Press F5 (CHLdrn). 

Agenda displays a symbol (*) next to all the child categories. 

Agenda displays all the child categories in the Sections setting of 
the View Add box. 

7. Complete the settings and press enter. 

Agenda displays the new view with the child categories as section 

heads, as well as any items assigned to these categories. 

Note If you display all child categories in a view and later add 

more children under the parent category. Agenda automati¬ 
cally adds these children as section heads to this view. For 
example, if you get the Quickprint company as a new account 
and add it to the category hierarchy as another child of Com¬ 
pany, Quickprint automatically displays in the By Company 


Modifying Views 


You may want to modify views by adding or deleting sections, filter¬ 
ing information in views, or sorting items within sections. You use 
the View Properties settings to make these changes. 

To modify a view: 

1. Press Fio (MENU) and select View Properties. 

Agenda displays the View Properties box. The settings are 
described in the following section. 

2. Modify the settings and press ENTER. 

Agenda displays the view with the changes you make. 
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Tip You can also modify a view from the view manager. Just high¬ 
light the view name and press F6 (PROPS) to display the View 
Properties box, then modify the settings. 


View Add/View Properties Settings 


You use the settings in the View Add box to add a new view and the 
settings in the View Properties box to modify an existing view. The 
View Properties box displays the current name, sections, and filters of 
an existing view. These settings are blank in the View Add box until 
you complete them. The View Add box displays an additional set¬ 
ting, Type. 

View name Specify a view name of up to 37 characters. If you type 
a name in the View Properties box. Agenda replaces the current view 
name with the new name. 

Type (View Add box only) Specify what type of view you want. 
Choices are Standard (default) and Datebook. (See Chapter 10.) 
Sections Specify the category or categories that you want to use as 
section heads in this view. You can type new category names or 
select existing ones. The View Properties box displays section heads 
in the current view. You can add, delete, and rearrange these section 

To specify a section head, do one of the following: 

• Type the name of a new or existing category and press ENTER. 

• Press F3 (CHOICES) and select an existing category from the cate¬ 
gory hierarchy. See "Selecting Categories to Display as Section 
Heads" in the following section. 

Once you enter a category name, you can press F2 (edit) to edit it, del 
to remove it, ALT-Eio (MOVE) to move it, or F6 (props) to display sec¬ 
tion properties. 

Filter Specify how you want to filter the information in the view (by 
category, dates, or numbers). (See Chapter 11.) 

Item sorting Specify how you want to sort items in the view. (See 
Chapter 15.) 

Section sorting Specify how you want to sort sections in the view. 
(See Chapter 15.) 



Hide empty sections Indicate whether you want to display section 
heads if they have no items assigned to them. The choices are Yes 
and No (default). (See Chapter 5.) 

Hide done items Indicate whether you want to display items once 
they are designated as done. An item is done if it has a Done date of 
the current date or earlier. (See Chapter 13.) The choices are Yes and 
No (default). 

Hide dependent items Indicate whether you want to display items 
that you can't complete until you complete a prerequisite item. (See 
Chapter 13.) The choices are Yes and No (default). 

Hide inherited items Indicate whether you want to display items 
that are assigned to descendents of the section head. (See Chapter 
13.) The choices are Yes and No (default). 

Hide column heads Indicate whether you want to display column 
heads only in the first section on the screen. This setting enables you 
to eliminate the display of redundant column heads when all sections 
in the view have the same columns. The choices are Yes and No 
(default). 

Section separators Indicate whether you want a line to separate 
each section. (See Chapter 5.) The choices are Yes and No (default). 
Number items Indicate whether you want the items numbered in 
each section. The choices are Yes and No (default). 

View statistics Press space bar to see how many marked items, 
sections, and items the view contains. 

Named print set Specify the name of an existing Named print set¬ 
tings file that contains the print settings you want to attach to the 
current view. You can also detach this file. For more information 
about how to create a named print set, see Chapter 17. 

View protection Displays the types of changes users can make to 
the view. Use the Global protection settings under the File Proper¬ 
ties command to specify this information. The default is Global (No 
protection). For more information about global protection, see 
Appendix G. 




Selecting Categories to Display as Section Heads 


When you add or modify the sections in a view, you can select cate¬ 
gories to display as section heads from the list of categories in your 

To select the categories to display as section heads in a view: 

1. Do one of the following: 

• Press Flo (menu) and select View Add to add a view. 

• Press Flo (MENU) and select View Properties to modify a view. 

2. Highlight Sections and press F3 (choices). 

Agenda displays the Section Select box containing the category 
hierarchy (Figure 9-7). 

3. To select section heads, do one of the following: 

• Highlight a category that you want to use as a section head 
and press SPACE BAR or F7 (INCLCAT). 

Agenda displays a symbol (*) next to the category that you 

• Press Fs (chldrn) to select all the children of a parent 
category. 

Agenda displays a symbol (*) next to all the child categories. 
To remove section heads, do one of the following: 

• Highlight a category with a symbol (*) beside it and press 
space bar or F7 (INCLCAT) to remove a particular section head. 

• Press F4 (CLRCATS) to remove all section heads. 

4. Repeat Step 3 until you select all the categories you want to use 

5. Press enter twice to return to the view. 

Agenda displays the view with the sections you specify. 
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Accepting a 
Partial Match a: 
a New Parent 


• Create a new family. For example, you want to create a new 
parent category as well as new child categories, and you want to 
make sure the new children fall under the new parent. 

To replace a category in a view by specifying a parent: 

1. Highlight the section head, column head, or column entry whose 
category you want to replace. 

2. Do one of the following: 

• If you're replacing a column entry, skip to Step 3. 

• If you're replacing a section head or column head, press 
F6 (PROFS). 

Agenda displays either the Section Properties box or the 
Column Properties box. 

3. Type the parent category whose child category you want to use in 
the viejy (but don't press enter). 

4. Press ALT-F5 (NEWPAR) or ctrl-enter. 

Agenda prompts you to specify the child category itself. 
Remember that this is the category that Agenda displays as the 
section head, column head, or column entry. 

5. Type the name of the child category and press ENTER. 

If you're in the Section Properties or Column Properties box, 
press enter again. 

Agenda displays the child category as the current section head, col¬ 
umn head, or column entry. 

As you begin to type a category name. Agenda tries to match the 
name with an existing one in the category hierarchy. You can accept 
a partial match (what you have typed so far) as a new parent 
category. 

For example, you might already have the category Staffing in your 
file, and you want to create Staff as a new parent category. When you 
type Staff, Agenda displays Staffing. Press alt-fs (Accpar) to 
accept Staff as a new parent category; then type the name of the child 
category that you want to use in the view. 



Copying Existing Views 


You might want to add a view similar to an existing one. For exam¬ 
ple, you might want to add a view with the same sections but with 
different columns. To do this, you can make a copy of an existing 
view and then replace the column heads with other categories. 

To copy an existing view: 

1. Press fs (vw mgr). 

Agenda displays the view manager. 

2. Highlight the view you want to copy. 

3. Press ALT-F9 (COPY). 

Agenda displays the Copy View box. The settings for this box 
are described in "View Add/View Properties Settings" earlier in 
this chapter. 

4. Type a name for the new view and press enter. 

5. Complete or modify the settings and press enter. 

Agenda displays the new view with the name and the properties you 
specify. 


Deleting Views 


You can delete a view if you no longer want it. Deleting a view does 
not remove information from your file. The items and categories 
remain in your file; the items remain assigned to the categories that 
were in the view. You can display both the items and categories in 

To delete a view: 

1. Press FStVW MGR). 

Agenda displays the view manager. 
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2. Highlight the name of the view that you want to delete and press 
DEL or F4 (DELETE). 

Agenda asks you to confirm that you want to delete the high¬ 
lighted view. 

3. Press enter to delete the view. 

Agenda deletes the view from the file. 

Tip If you're currently displaying a view that you want to delete, 
use the View Discard command. 

Rearranging the List of Views 


You can rearrange the position of view names in the view manager. 
For example, you might want to change the order in which Agenda 
displays views when you use the accelerator keys ALT-N and ALT-F. 
To rearrange the list of views: 

1. Press F8 <vw MGR). 

Agenda displays the view manager. 

2. Highlight the view you want to move and press alt-fio (move). 
Agenda displays a symbol (») beside the view you select. 

3. Use T or l to move the symbol to the view name below or above 
which you want to place the view in the list. 

4. Do one of the following: 

• Press ENTER to insert the view name below the symbol. 

• Press CTRL-ENTER to insert the view name above the symbol. 
Agenda rearranges the list of views and removes the symbol beside 
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Sorting the List of Views 


You can also sort a list of views alphabetically. You may want to do 
this if you have many views and you want to quickly scan the list. 
To sort a list of views alphabetically: 

1. Press F8 (vw mgr). 

Agenda displays the view manager. 

2. Press ALT-F5 (SORT). 

Agenda sorts the list of views alphabetically. To sort information in 
the view, see Chapter 15. 

Changing View Names 


Once you add a view, you might want to change its name to better 
describe its contents. 

To change a view name: 

Agenda displays the view manager. 

2. Highlight the view whose name you want to change and press 

3. Edit the name of the view. 

4. Press ENTER twice to return to the renamed view. 

Agenda displays the view with the new name. 

Tip You can also change the name of the current view by changing 
the View name setting under the View Properties command. 



Chapter 10 

Managing Your Schedule 


Agenda provides tools to help you manage your schedule. You can 
use datebook views to schedule activities and appointments and 
then browse through the datebook views to look at other dates. You 
can use alarms to remind you of important events. For example, you 
can set an alarm to ring before a meeting you must attend or a phone 


In this Chapter 


This chapter describes how to 

• Create and use datebook views 

• Browse through a datebook view 

• Display your schedule for a specific day 

• Set alarms to remind you of important events 

Before you read this chapter, you should be familiar with dates and 
times and how to specify them. (See Chapter 6.) 


About Datebook Views 


You use views in Agenda to enter and display information. You use 
datebook views to enter and display information that is organized 
according to dates and times. 

You can use datebook views to set up a daily appointment book, a 
1 ' 1 ' Va-glance view, or a quarterly view of your 
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schedule. 




specific day, week, month, or quarter. 

For example, if you want to schedule a meeting for Tuesday, 
November 6 at 10:00 am, you open your appointment book to 
November 6 to see what other meetings and tasks you scheduled for 
that day (Figure 10-1). 



Figure 10-1 One day front an appointment book 


A datebook view is simply an online appointment book. You can use 
a datebook view to display a view that looks like one page of a daily 
appointment book with a section for each hour of the day. Agenda 





"Sales team" and 'Meeting" if these categories exist in the file. 

You can also display your appointments for a specific week. For 
example, if you know you want to schedule a four-hour meeting dur¬ 
ing the week, you can use a weekly datebook view to see which day 
of the week is best for the meeting. Agenda displays a view that 
looks like a page from a weekly appointment book with a section for 
each day of the week (Figure 10-3). 







Creating a Datebook View 


Creating a datebook view is similar to creating any other view. This 
section describes how to create a datebook view. For information on 
adding a standard view, see Chapter 9. 

There are four types of datebook views: 

• Daily 

• Weekly 

• Monthly 

• Quarterly 

To create a datebook view: 

1. Do one of the following: 

• Press Fio (MENU) and select View Add. 

• Press F8 (VW MGR) and press INS. 

Agenda displays the View Add box, which includes the 
View name and Type settings. 

2. Type a name for the view and press enter. 

3. Highlight Type and press SPACE BAR to select Datebook. 
Agenda displays additional settings that relate to datebooks 
(Figure 10-4). These settings are described in the following 

4. Complete the datebook settings and press ENTER. 

Agenda creates the datebook view. 













Agenda displays the Interval s 
Quarter for Period. 

If you create a daily datebook v 
have the following choices: 


Hourly (default) Agenda creates. 

hour of the day. 
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If you create a quarterly datebook view (by choosing Quarter for 
Period), you have the following choices: 


Daily 
Weekly (default) . 



Start at Specify a beginning day or time for the view. 

Agenda displays the Start at setting if you choose Day or Week for 

Period. 

The choices for this setting change, depending on what you choose 

for the Period setting: 

• If you create a weekly datebook view (by choosing Week for 
Period), specify a day of the week. The default is Mon (Monday), 
unless you spedfied a different day for Beginning of week in the 
Global Date Settings box. (See Chapter 7.) 

• If you create a daily datebook view (by choosing Day for Period), 
specify a time. The default is 8:00am, unless you specified a differ¬ 
ent time for Morning in the Global Date Settings box. 

To specify a time: 

• Highlight Start at, type the time, and press ENTER. 
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Examples of 
Creating 
Datebook Views 


End at Specify an ending day or time for the view. 

Agenda displays the End at setting if you choose Week or Day for 
Period. 

• If you create a weekly datebook view, specify a day of the week. 
The default is Fri (Friday), unless you specified a different day for 
End of week in the Global Date Settings box. (See Chapter 7.) 

• If you create a daily datebook view, specify a time. The default is 
5:00pm, unless you specified a different time for Evening in the 
Global Date Settings box. (See Chapter 7.) 

To specify a time: 

• Highlight End at, type the time, and press enter. 

Base date on Specify the period start date for the datebook view. If 
you want the view to be based on a relative date, specify a relative 
date for Base date on (for example, today, tomorrow, this week, next 
week). If you want the view to be based on an absolute date, specify 
an absolute date for Base date on (for example, March 1,1990). For 
information about relative and absolute dates, see Chapter 6. 

For example, if you create a daily datebook view to always show 
today's schedule, accept the default Today for Base date on. If you 
create the view on November 10, on November 10 Agenda displays 
your schedule for November 10. If you look at the same view on 
December 15, Agenda displays your schedule for December 15. 


If you want to create a datebook view for the current week, you can 
accept all the defaults for the datebook settings: 


Accept the following default 




(leave blank) 
When 
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The following table shows the choices you specify if. you want to 
create a daily view that always displays tomorrow's schedule 
between 7:30 am and 6:00 pm, with a section for each half-hour. 


Specify 


Date category 

Section 

Period 

Interval 



When 
(leave blank) 
When 
Day 


7:30am 


The following table shows the choices you specify if you want to 
display only your meetings for the week starting on Monday, 
November 5 and ending on Saturday, November 10. 


For this setting Specify 

Date category When 

End category (leave blank ) 

Section Meetings 




Mon 


Base date on 


November 5 


A datebook view is like a standard view. You use the same proce¬ 
dures and keys to add and discard items in a datebook view that you 

For example, if you want to enter an item about a status meeting 
scheduled for 4:00 pm today, you add the item "Status meeting" to a 


Adding and 
Discarding Items 
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daily view for today, under the time 4:00. Because you enter the item 
under 4:00, Agenda gives the item a When date with today's date and 
a time of 4:00. 

If a meeting is canceled and you want to discard the item from the 
file, you use the same procedure to discard the item as you use in a 
standard view. (See Chapter 3.) 


Restrictions for Note die following restrictions when working with datebook views: 

Datebook Views 

• You can't change a datebook view to a standard view or a stan¬ 
dard view to a datebook view. 

• You can't add a section to a datebook view or delete a section 
from a datebook view. 

• You can't change the built-in section filters in datebook views. 
(Use view filters to filter all sections in the view.) 


Browsing Through a Datebook View 


Once you create a datebook view, you can browse through it to other 
days, weeks, or months, just as you might look through your appoint¬ 
ment book to future dates. Browsing through a datebook view is just 
like flipping through the pages of your appointment book. 

You use the View Browse command in a datebook view to start 
browsing. You can browse forward and back through days, weeks, 
months, or quarters to see the appointments and tasks that are sched¬ 
uled for specific time periods. 

For example, if you are in a datebook view for the current week and 
you want to see the appointments and commitments that you have 
during the following week, you can browse forward one week. 
Agenda also lets you move directly ahead to specific dates in the 
future. For example, if s now autumn, and you're planning a confer¬ 
ence for the coming spring. To determine the best dates for a three- 
day conference in the spring, you can jump ahead to March and 
browse through your activities and commitments for each week in 
March, April, and May to help you decide which is the best week for 
the conference. 
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To browse through a datebook view: 

1. Press Flo (menu) and select View Browse. 

Agenda displays the BROWSE indicator in the upper right corner 


2. Do one of the following: 

• Press -> to move forward one period. 

• Press <- to move backward one period. 

While you're browsing, you can only move forward and back by 
period. You cannot edit items, insert new items, and so forth. 

3. To stop browsing, do one of the following: 

• Press enter to accept the new datebook view. 

• Press esc to return the datebook view to where it was when 
you created the view. 

Example 

For example, suppose you create a datebook view for the week of 
November 19 through November 23. 

If you press enter to stop browsing. Agenda saves the new datebook 
view for the week of November 19 through November 23. 

If you press ESC to stop browsing. Agenda returns the datebook view 
to where it was originally when you created the view, November 5 


Moving to Another in addition to using the arrow keys when you're browsing through a 
Date datebook view. Agenda lets you jump ahead or back to a specific 

date. To jump to a specific date: 

Agenda displays the Date prompt in the upper left comer of the 


2. Type the date to which you want to move and press enter. 
Agenda displays a datebook view for the date you specify. 



Shortcut tO To use accelerator keys to browse through a datebook view: 

Browsing Through 
a Datebook View 

1. Press alt-b and use or <- to browse forward or back through 
the datebook view. 

2. To stop browsing, do one of the following: 

• Press ENTER to accept the new datebook view. 

• Press esc to return the datebook view to where it was when 
you created the view. 


Displaying Your Schedule 


Agenda easily lets you display your schedule for today or for any 
other day in the future or past, without adding a datebook view. By 
default. Agenda displays all items assigned to the day you specify. 
For example, you plan to take a vacation day on December 14 and 
you want to check your schedule for that day to determine if you can 
be out of the office (Figure 10-6). 
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Figure 10-6 Sample schedule for December 14 


Once you display your schedule for December 14, you see that you 
have many appointments and meetings on that day as well as a 
report that is due at the end of the day. So, you check your schedule 
for the following Friday, December 21, and find that December 21st is 
a better day to be away from the office. 
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You can also set Agenda to display only items assigned to a specific 
category instead of all items for a specific day. The following two 
examples show why you might want to display only items assigned 
to a specific category. 

• You want to display only the items that you've ranked most 
important on a specific day. If your file has a category called 
Urgent, you can display only those items assigned to Urgent. This 
lets you attend to the urgent items first. 

• You decide you will take the day off, but will make work-related 
phone calls from home. You can display only the items that are 
assigned to the category Calls. 

To display your schedule for a specific date: 

1. Press Flo (MENU) and select Utilities Show Sched. 

Agenda displays the Show Schedule box. The settings are 
described in the following section. 

2. Complete the settings and press enter. 

Agenda creates a view called "Show View* that displays all the items 
for the date you specify (Figure 10-6). 


Show Schedule You use the Show Schedule settings to specify the date for which you 
Settings want Agenda to display items. You can specify whether to display 

all items or just items assigned to specific categories. 

Date category Specify the date category that Agenda uses to dis¬ 
play items in the view. The default is the When date category. 

In most cases you can use the default. However, if you create another 
date category that tracks dates similar to When dates, you may want 
to specify that date category instead. 

Section head Specify the name of the category that heads the sec¬ 
tion for the view. Agenda uses what you specify for Date category as 
the default for Section head. 

Date Specify the date for which Agenda should display items. The 
default is the current system date. 
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You can specify a date in one of the following ways: 

• You can enter a date using numbers (for example, 11/14/90) or 
words (for example, today or ten days from now). 

• You can use the pop-up calendar to select a date. Press 

F3 (CHOICES) to display the pop-up calendar, select a date, and 
press ENTER. For information about the keys you use to select a 
date, see Chapter 6. 

Fi Iter Specify the name of the category by which to filter the view. 

To display only items assigned to a specific category, specify the 

name of the category. 

For example, to display only meetings, specify the category 

Meetings for Filter. For information about how to attach a filter, 

see Chapter 11. 

To display all items for a specific date, leave the Filter setting blank. 

Note When you use the Show Sched command. Agenda uses what 
you specify for the Date category and Filter settings to deter¬ 
mine which items to display. Thus, if you want to display all 
phone calls you have to make on December 21 (that is, all 
items that have a When date of December 21 and that are 
assigned to the category Calls), specify the following for the 
Show Schedule settings: 


For this setting Specify _ 

Date category When 

Date December 21,1990 

Filter _Calls_ 


About Alarms 


You can set an alarm to remind you of an event that is about to hap¬ 
pen or an item that needs your attention. For example, if you have a 
2:00 meeting, you can set an alarm to ring five minutes before the 
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Set Alarm Settings You use the Set Alarm settings to control when the alarm rings for an 

Date category Specify the date category that Agenda compares to 
the current system date and time to determine when to ring the 
alarm. The default is the When date category. 

In most cases, you can use the default. However, if you create 
another date category that tracks dates similar to When dates, you 
may want to specify that date category instead. 

Minutes before Specify the number of minutes before the event that 
you want Agenda to ring the alarm. You can type any number from 
0 through 60. The default is 5 minutes. 


Shortcut to Setting To use accelerator keys to set an alarm: 

Alarms on Items 

1. Highlight the item on which you want to set an alarm. 

2. Press ALT-A. 

Agenda displays the Set Alarm box. 

3. Complete the settings (described in preceding section) and press 


Checking the Agenda maintains an alarm list. You can check the alarm list to see 

Alarm List which items in a view have alarms set on them and which items have 

alarms that have already gone off (Figure 10-8). 
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If you set alarms on many items, the alarm list may get long by the 
end of the day. At the end of the day. Agenda removes all items from 
the !Past Alarms! section of the alarm list. Once an alarm goes off 
and you check the alarm list, you may want to remove the item from 
the !Past Alarms! section of the alarm list. 

To remove an item from the !Past Alarms! section of the alarm list: 

1. Press Flo (MENU) and select Utilities Show Alarm. 

2. Highlight the item that you want to remove from the alarm list 

Agenda removes the highlighted item from the alarm list. 

You can also mark several items and remove the marked items from 
the alarm list. (See Chapter 13.) 

Items that you remove from the alarm list remain in any other views 
that they're in. 

Canceling Alarms You can cancel an alarm if you decide you no longer want it set. 

on Items ’ 8 

For example, if you set an alarm on the item "Meeting today at 3:00”, 
and you decide not to attend the meeting, you probably don't want 
the alarm to sound to remind you of the meeting. 

To cancel an alarm on an item: 

1. Highlight the item on which you want to cancel the alarm. 


Removing Items 
from the Alarm List 


Agenda cancels the alarm on the item. 



Chapter 11 
Filtering Information 


Views let you look at your information from different perspectives. 
You can restrict the information you display in a view by attaching 
filters to the view or to individual sections. Filters allow you to sift 
through specific portions of your information. 


In this Chapter 


This chapter describes how to 

• Filter views and sections to display only items assigned to certain 
categories, dates, or numbers 

• Edit and clear filters 

• Attach multiple filters using the category hierarchy 


About Filtering Views 


You may want a view to include only items that meet particular 
criteria. For example, you may have a Tasks view with sections for 
each type of activity such as Memos or Follow-ups. Rather than dis¬ 
playing all the items in each section, you can filter this view to see 
only the memos you have to write, your high priority memos, or the 
high priority memos you must write this week. You can quickly 
focus on specific information to make decisions about what tasks 
need to be accomplished right away. Views let you look at your 
information from different perspectives; filters let you look at specific 
information in the view. 



11-2 Filtering Information 


You attach filters to display items that meet particular criteria. Filters 
pertain only to the current view. You can attach one or more filters 
per view and you can easily edit these filters to look at different por¬ 
tions of your information. You can filter views by 
• Category 

For example, you can look at only the high priority memos you 


A date or a range of dates 

For example, you can look at all the calls you made to the Gifford 
account last month. 

A number or range of numbers 

For example, you can look at all expenses over $500. 


Filtering Views by Category 


When you filter a view by category. Agenda displays only the items 
assigned (or not assigned) to the category or categories that you 
specify. 

For example, Figure 11-1 shows an unfiltered view. Items are 
assigned to High, Medium, and Low Priority categories. 



Figure 11-1 An unfiltered view 

You can filter the view to show all items assigned to the High cate¬ 
gory (Figure 11-2). Agenda displays the filter next to the view name 









To filter a view by category: 

1. Press Flo (MENU) and select View Properties. 

Agenda displays the View Properties box. 

2. Highlight Filter. 

3. Type the name of an existing category and press enter. 

Agenda displays the Assignment Filter box and asks you what 
items you want to display. 

4. Specify whether you want Agenda to display all items that are 
assigned to the category or all items that aren't assigned to it. 

Agenda displays the category filter in the View Properties box. 
To interpret these filters, see "Interpreting Filters" later in this 

6. Repeat Steps 3 through 5 until you select all the categories you 
want to include in the filter. 


Agenda displays the current view filtered by the category or catego¬ 
ries you select (Figure 11-2). The filter appears next to the view name 
in brackets ([ ]). To interpret the filter, see "Interpreting Filters" later 
in this chapter. 

Tip You can also attach filters using the view manager. Highlight 
the view you want, press F6 (props), and edit the Filter setting. 







How Agenda 
Assigns Items in 
Category Filters 


Filtering Views Using Several Categories 













Assigned (default) Displays all items assigned to the date category 
Not assigned _Displays all items not assigned to the date category 


If you choose Assigned, you can use specific dates to further filter the 
view. To display all items assigned to a date category (for example, 
all When dates), do not specify a start or end date. To display all 
items without assigned dates, choose Not assigned. 

Start date Specify the start date for the range of dates Agenda uses 
to filter the view. Leave this setting blank if you want a range that 
begins with the earliest date in your file. 

Completing the Start date setting displays the additional setting 
Items should be. 
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End date Specify the end date for the range of dates Agenda uses to 
filter the view. Leave this setting blank if you want a range that ends 
with the latest date in your file. 

Items should be Choose whether to display items in the date range 
or items not in the date range. 


Choice _ Result 


Displays all items with dates that fall' 


Outside range Displays all items with dates that fall outside the date 


The Items should be setting displays if you complete the Start date 
or End date setting. 


How Agenda If you enter an item in a view filtered by date. Agenda assumes that 

Assig ns Items in the item belongs in the view, so it assigns an appropriate date to the 

Date Filters item. For example, if you enter an item in a view filtered by Entry 

date. Agenda assigns an Entry date based on the filter regardless of 
the current date. If you filter the view to show items within a date 
range. Agenda assigns the first date in the date range (the Start date) 
to the item. If you filter the view to show items outside a date range, 
Agenda assigns the date before the Start date to the item. 

If you use relative dates for Start date and End date (today, Monday, 
and so forth). Agenda continually reinterprets them against the sys¬ 
tem date. For example, if you have a date range of Monday to Friday, 
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Agenda interprets that range as Monday to Friday for the current 
week. Agenda reinterprets the dates the following week. Thus, you 
can create a view that always includes items for the current week. 

Agenda provides datebook views with preset filters to display daily, 
weekly, monthly, or quarterly information. For more information 
about datebook views, see Chapter 10. 

Browsing Through Agenda lets you browse through standard views or sections filtered 
Date Filters by date to look forward or back through time. When browsing, you 

can shift the time filter by day, week, month, or year. This is a conve¬ 
nient way to quickly look at items in past or future time frames. For 
example, if you display today's high priority calls, you can quickly 
view tomorrow's high priority calls. For more information about 
browsing in datebook views, see Chapter 10. 

You move the date filter using the View Browse command. To 
change the timeframe for a view or section: 

1. Press Flo (MENU) and select View Browse. 

Agenda displays the BROWSE indicator in the upper right corner 
of the screen. 

2. Use the keys in the following table to move the time filter for¬ 
ward and back. While you're browsing, you cannot edit items or 

3. To stop browsing, do one of the following: 

• Press enter to accept the new date filter. 

• Press ESC to return to the date filter you were in before using 
the View Browse command. 

Agenda displays the items for the date filter you specify. You can 
add new items or edit current ones. If you attach more than one date 
filter. Agenda browses through the dates simultaneously. 

The keys in the following table let you move the time filter forward 
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Forward one day 
Back one day 

Back one week 
Forward one month 


Press this key 


To a specific date 


ALT-F5 (GO TO) 


Shortcut to 
Browsing 
Date Filters 


To use accelerator keys to browse a date filter in a view or section: 


1. Press alt-b and use the keys in the table above to move the date 
filter forward or back. 

2. To stop browsing, do one of the following: 

• Press ENTER to accept the new date filter. 

• Press esc to return to the date filter you were in before using 
the View Browse command. 


Filtering Views by Number 


When you filter a view by number. Agenda displays only those items 
that fall within (or outside of) the range of numbers you specify. For 
example, you might want to display only equipment costs under 
$1000. 

Figure 11-7 shows an unfiltered view. This view shows costs for all 
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4. Complete the settings and press enter. 

Agenda displays the numeric filter in the View Properties box. 
To interpret the filter, see "Interpreting Filters" later in this 

5. Press enter. 

Agenda displays the current view filtered by the numbers you select 
(Figure 11-8). The filter appears next to the view name in brackets 
([ ]). To interpret the filter, see "Interpreting Filters" later in this 

Tip You can also attach filters using the view manager. Highlight 
the view you want, press F6 (PROPS), and edit the Filter setting. 

Numeric Filter You use the Number Filter settings to define the range of numbers 

Settings Agenda uses for the filter. 

Show items if they are Choose the items you want Agenda to 
display. 


Choice Result 


Assigned (default) Displays all items assigned to the numeric category 
Not assigned _ Displays all items not assigned to the numeric category 

To filter the view by all items assigned to the numeric category (for 
example, if you want to look at all costs for a particular category), do 
not specify a minimum or maximum value. You can choose Not 
assigned to display all items without assigned numbers. 

Minimum value Specify the minimum value for the range of num¬ 
bers Agenda uses to filter the view. Leave this setting blank if you 
want a range that begins with the lowest number in your file. 

Completing the Minimum value setting displays the additional set¬ 
ting Items should be. 

Maximum value Specify the maximum value for the range of num¬ 
bers Agenda uses to filter the view. Leave this setting blank if you 
want a range that ends with the highest number in your file. 

Items Should be Choose whether to display items in the numeric 
range or items not in the numeric range. 
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Assigns Items in 
Numeric Filters 


Choice Result 


Inside range Displays all items with numbers that fall within the 
Outside range Displays all items with numbers that fall outside the 


The Items should be setting displays if you complete the Minimum 
value or Maximum value setting. 


If you enter an item in a view filtered by numbers. Agenda assumes 
that the item belongs in the view, so it assigns an appropriate num¬ 
ber. For example, if you filter a view by Cost (a numeric category), 
Agenda assigns a number based on the filter. If you filter a view to 
show items within a numeric range. Agenda assigns the first number 
in the range (the Minimum value) to file item. If you filter the view 
to show items outside a numeric range. Agenda assigns the number 
preceding the Minimum value to the item. 


Filtering Sections by Category, Date, or Number 


You may want to filter information in a particular section (instead of 
applying the filter to the entire view). For example, if you have a 
Tasks view with sections for each type of activity such as Calls, 
Memos, or Follow-ups, you can quickly filter an individual section 
such as Calls to show high priority calls. 

As in a view, you can attach category, date, or numeric filters to a 
section. For example. Figure 11-9 shows an unfiltered view. Items 
are assigned due dates and priorities. 










Filtering Information 


To filter a section: 

1. Place the highlight in the section you want to filter. 

2. Press Flo (menu) and select View Section Properties. 

Agenda displays the Section Properties box. 

3. Highlight Filter. 

4. Type the name of an existing category and press enter. 

Depending on the type of category you chose (standard, unin¬ 
dexed, date, or numeric). Agenda displays the appropriate Filter 
box and asks you what items you want to display. 

5. Specify whether you want Agenda to display all items that are 
assigned to the category or all items that aren't assigned to it. 

6. Press enter. 

7. Repeat Steps 4 through 6 until you select all the categories you 
want to include in the filter and press ENTER. 

Agenda displays the current section filtered by the category or cate¬ 
gories you select (Figure 11-10). The filter appears next to the section 
head in brackets ([ ]). For more information about how to interpret 
the filter, see the following section. 

How Agenda 
Assigns Items in 
Filtered Sections 


If you filter a section by dates, you can move the date filter forward 
and back using the View Browse command. See "Browsing Through 
Date Filters" earlier in this chapter. 


If you enter an item in a filtered section. Agenda assumes that the 
item belongs in the section, so it assigns the item to the categories you 
used as filters. For example, if you enter an item in a Memos section 
filtered by due date and High priority. Agenda assigns the item to the 
categories Memos, Due Date, and High Priority. 

Agenda assigns dates and numbers for items in filtered sections the 
same way it assigns dates and numbers in filtered views. For more 
information, see "How Agenda Assigns Items in Date Filters" and 
"How Agenda Assigns Items in Numeric Filters" earlier in this 
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Agenda displays filters next to the view name or section head in 
brackets ([ ]) or in the Filter setting for the Properties box. The fol¬ 
lowing table shows filters and how to interpret them. 


[Calls] Display all items assigned to the Calls 

category 

[-Calls] Display all items not assigned to the Calls 


[When(12/26/9(k-»12/30/90)] 

[Cost(1000<->)] 

[When(<-»end of this year)] 

[When-(today)] 

[Expense-(500<-»)] 
[Entry-(<-»12/31 /90)] 

[Done-(l /01 /90ol2/31/90)] 


Display items with When dates from 
12/26/90 through 12/30/90 
Display items with costs of $1000 and over 
Display items with When dates through the 
end of the year 

Display items with When dates other than 
today's date 

Display items with expenses below $500 
Display items with Entry dates after 1990 
Display items with Done dates other than 


Editing Filters 


You edit view filters using the View Properties command and sec¬ 
tion filters using the View Section Properties command. You can 


• Whether to show items if they are assigned or not assigned to the 
category you use as a filter 

• For date and numeric filters, what the range is and whether to 
show items inside or outside the range 

To edit a filter: 

1. Press fio (menu) and select View Properties to edit a view 
or View Section Properties to edit a section filter. 


r filter 



2. Highlight Filter. 

3. Highlight the filter you want to edit and press F4 (values). 
Agenda displays the appropriate box for the filter type. 

4. Highlight and edit the settings you want to change. When you 
finish, press enter twice. 

Agenda displays the view with the edited filters. 

Tip You can also edit view filters using the view manager. High¬ 
light the view you want, press F6 (PROPS), and edit the Filter 


Clearing Category Filters 

You can clear one, some, or all filters. You use the View Properties 
command to clear filters from the current view and the View Section 
Properties command to clear filters from the current section. 

To clear filters one at a time: 

1. Press Flo (MENU) and select View Properties to clear view filters 
or View Section Properties to clear section filters. 

2. Highlight Filter. 

3. Highlight the filter you want to clear and press DEL. 

Agenda removes the filter. 

4. Press ENTER to return to the view. 

Agenda displays the view with the current filters, if any. 

To clear all filters: 

1. Press Flo (MENU) and select View Properties to dear view filters 
or View Section Properties to clear section filters. 

2. Highlight Filter and press F3 (CHOICES). 

Agenda displays the category hierarchy. 

3. Press F4 (CLRCATS). 

Agenda asks if you want to remove all the filters. 
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4. Press enter three times to remove all filters. 

Agenda displays the view without any filters. 

Tip You can also dear view filters using the view manager. High¬ 
light the view you want, press F6 (PROPS), and edit the Filter 
setting. 


Attaching Several Filters Using the Category Hierarchy 


You can attach and edit filters using the category hierarchy. This 
method is useful for attaching and editing several filters at the same 


To attach or edit more than one category used as a filter: 


1. Press Fio (MENU) and select View Properties to work with view 



I 



If you highlight a date or numeric category. Agenda displays the 
appropriate filter box. 

4. For a date or numeric category, highlight Show items if they are 
and choose Assigned, Not assigned, or Clear filter. Edit any 
other settings, if necessary, and press ENTER. 
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5. Repeat Steps 3 and 4 until you attach all the filters the way you 
want them. 

6. Press enter twice. 

Agenda displays the current view filtered by the categories, dates, 
and/or numbers you select. 



Figure 11-11 Attaching several filters using the i 




Chapter 12 
Working with Notes 


Notes are a convenient way to keep additional or background 
information about specific items and categories in your file. 

You can use a note to store any information that's useful to you. For 
example, you can add a note listing the best times to reach a contact 
or a note containing the text of an electronic mail message you 
import. A note is only a keystroke away from an item or category. 


In this Chapter 


This chapter describes how to 

• Add and display notes 

• Work with text in notes 

• Copy items and their notes into a single note 

• Make text in a note into an item or a category 

• Append text from a note to an item or a category 

• Exchange information with external sources 

To search through notes, see Chapter 15. For information about 
printing notes, see Chapter 17. 










Working with Notes 


To add or display notes from a view or the category manager: 

1. Highlight the item or category to which you want to add a note. 

2. Press F5 (NOTE). 

To add a note, edit an existing note, or display notes from the Item 
Properties or Category Properties box: 

• Highlight Note and press space bar. 

For more information about entering a new note, see "Working with 
Text in Notes" later in this chapter. 


Shortcut to 
Displaying Notes 
for Items 


When you display a note for an item and want to move quickly to the 
note for the next or previous item, use the following accelerator keys. 


• ALT-N moves to the note for the next item 

• ALT-P moves to the note for the previous item 


To see notes for other items, continue pressing these accelerator keys. 
When there are no more notes to display. Agenda returns you to the 
current view. 


Returning to To return from a note to where you were, do one of the following: 

Where You Were 

• Press F5 (RETURN). 

• Press Flo (MENU) and select Return. 


If you make changes to the note and press ESC, Agenda asks 
whether to discard any changes you made to the note. Choose No 
(default) or Yes and press enter. 





Working with Text in Notes 


When you enter and edit text in notes, you can 

• Mark text (Chapter 14) 

• Cut, copy, and paste marked text (Chapter 14) 

• Search for and optionally replace text (Chapter 15) 

• Change attributes and/or typefaces for printing and print the note 
(Chapter 17) 

For basic Agenda editing procedures, see Chapter 14. 


Entering and When you enter text and it fills the current line. Agenda automati- 

Editing Text cally moves the cursor to the start of the next line and lets you con- 

in a Note tinue typing. 

To begin a new line, start a new paragraph, or create a paragraph 
heading, press ENTER. When you press ENTER, Agenda ends the cur¬ 
rent line and then moves the cursor to the next line. 

To control where lines end, display the note and press ENTER where 
you want each line to end. As you do this, you may want to display 
carriage returns in the note. To display carriage returns, in a view 
select Display carriage returns under the Utilities Customize 
command and choose Yes. 


1. Move the cursor to the location in the note where the text 
belongs. 


2. Type the text. 

As you type. Agenda adds characters at the cursor position. By 
default. Agenda inserts your characters in the line, adjusting the char¬ 
acters after the cursor so that no characters are deleted. If you want 
Agenda to overtype characters instead of insert them, press INS. You 
can press INS to toggle between insert and overtype mode. 

When you are in insert mode. Agenda displays the INS indicator in 
the upper right comer of the screen. When you are in overtype 
mode. Agenda displays the OVR indicator in the upper right corner 
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Structuring the 
Text of a Note 


By default. Agenda sets tab stops after every five characters. For 
example, the first tab stop occurs after the fifth character on the line 
of text, the second after the tenth character, the third after the 
fifteenth character, and so forth. Pressing TAB while you edit a note 
advances the cursor to the next tab stop. You can change the tab 
stops throughout Agenda by using the File Properties command. 


Agenda displays the File Properties box. 

2. Highlight Tab size and type the number that you want to use for 

3. Press ENTER twice. 

Agenda saves the new tab stop. When you press tab in a note or 
display any existing note text with tabs. Agenda uses the new tab 

Printing a Note For specific information about printing notes, see Chapter 17. 

When you print a note, paragraphs in the printed note might look 
different from the paragraphs on your screen because the printed 
page can contain more or fewer characters per line than the Agenda 
note screen. The lines of text on the printed page break in different 
places than on the screen. For information about how to control line 
breaks, see "Entering and Editing Text in a Note" earlier in this 
chapter. 


Copying Items into a Note 


You can copy the text from items (and their notes) into another note. 
For example, if you have a number of items that relate to the same 
subject, you can display these items (and their notes) in one place. 
For example. Figure 12-3 shows the note for the item "Check with 
Abigail Scheer on meeting times''. This note contains the text of two 
other items and their notes, which were copied into this note. 




Press F5 (NOTE). 


Agenda displays the note for the highlighted item or cate 
5. Move the cursor to the place where you want to insert thi 
marked items (and their notes). 


6. Press ALT-F8 (getitms). 
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Making the Text of a Note into an Item or a Category 


Sometimes when you look at, or edit, a note you see text that would 
be helpful as an item or a category. Procedures for making note text 
into items or categories are described in the following sections. 

Making the Text You can make text from a note into a new item. For example, a note 
Of a Note into might contain several tasks that would be more helpful as items, 

an Item When you make text in a note into an item. Agenda removes the text 

To make note text into a new item: 

1. In the note, do one of the following: 

• Move the cursor to the text that you want to make into an 


• Press F7 (mark) and highlight the text that you want to make 
2. Press ALT-F7 (MAKEITM). 

If you did not mark any text in Step 1, Agenda asks you what 
you want to make into an item. Choose Word (default). Line, or 
All Text and press ENTER. 

Agenda removes the specified text from the note and displays it as a 
new item in the current section in the view. To assign the item to a 
different category, use Assigned to setting under the Item Properties 
command. 


Note An item can only be 350 characters in length. If the text 

exceeds 350 characters, the remaining text becomes a note for 
the new item. 


Making the Text You can make text from a note into a new category. Forexample,a 

of a Note into note might include the name of a product that you want to make into 

a Category a category. 

When you make the text into a category. Agenda also keeps the text 
in the note. 
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To make note text into a new category: 

1. In the note, do one of the following: 

• Move the cursor to the word that you want to make into a 
category. 

• Press F7 (mark) and highlight the text that you want to make 
into a category. 


Agenda asks you to identify the parent of the new category. 

3. Do one of the following: 

• Type the name of the parent category and press enter. 

• Press F3 (choices), highlight a category, and press enter. 

4. Press enter again to return to the note. 

Agenda adds the new category as a child of the parent category. If 
there is no marked text. Agenda makes the highlighted word into a 
category. If you mark text and it exceeds 69 characters. Agenda 
makes the remaining text a note for the new category. (A category 
name can only be 69 characters.) 

In a view, you can press F9 (CAT MGR) to see that Agenda added the 
new category as a child of the parent category that you specified. 


Appending Text from a Note to an Item or a Category 


You can append text from a note to the item or category to which the 
note belongs. For example, you might want to append a company 
name in a note to the text of the current item. 

When you append text from a note to an item or category. Agenda 
removes the specified text from the note and inserts it at the end of 
the current item or category. 

To append text from a note to an item or category: 

1. Highlight the item or category that includes the note containing 
the text you want to append and press F5 (NOTE). 
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i Notes 


2. In the note, do one of the following: 

• Move the cursor to the text that you want to append to the 
item or category. 

• Press 17 (MARK) and highlight the text that you want to 
append. 

3. Press alt-fs (append). 

If you did not mark any text in Step 1, Agenda asks you what you 
want to append to the item (or category). Choose Word (default). 
Line, or All Text and press enter. 

Agenda removes the text from the note and appends it to the current 
item or category. 

Note If the appended text and the current item together exceed 350 
characters, or the appended text and the current category 
exceed 69 characters. Agenda leaves the remaining text in the 


Clearing the Text of a Note 


You can clear the text from a note. For example, you can clear the 
text from a note if it contains information that no longer applies to the 
item such as information about a discontinued product line. 

Clearing the text from a note deletes the note from your Agenda file. 
To delete part of a note or cut part of a note so you can paste it 
elsewhere in the note, see Chapter 14. 

To clear a note: 

1. In the note, press Flo (MENU) and select Clear. 

Agenda asks whether you want to clear all text from the current 


2. Choose Yes (default) to clear the note or No to retain the note 
and press enter. 

If you choose Yes in Step 2, Agenda clears the current note. Other¬ 
wise, Agenda keeps the note in your file. 
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Exchanging Information with External Sources 


You can exchange information in a note with external sources. 
Agenda lets you add text from memos or other documents created 
with other software products. You can incorporate electronic mail, 
business or legal information, or any other information from external 

Agenda lets you exchange information from external sources in two 
ways. You can 

• Import information from an external text file into a note 

When you import information into a note, you copy the contents 






Importing 
Information 
from Text Files 
into a Note 


contain hidden formatting codes or special characters. To 
make an ASCII text file, use the procedures described in that 

You can import information from an external text file into a note and 
export the text from a note to an external text file. 


You import information from an external text file into a note by 
bringing text from other programs into your Agenda file. For exam¬ 
ple, you can import a memo you composed with your word proces¬ 
sor. You can also print a Lotus 1-2-3 worksheet to a text file and then 
import that text file into an Agenda note. 

When you import the contents of an external text file. Agenda makes 
a copy of the text and imports the copy into your note. 

Note The text to be imported must be in an ASCII text file. You do 
not, however, need to use the TXT2STF utility to prepare the 
text. You only need to use that utility if you want to import 
multiple types of information (such as items and notes) at the 

types of information, see Chapter 23. 

To import text into a note: 

1. In the note, move the cursor to the location where you want the 
imported text to appear. 

2. Press Flo (menu) and select Import. 

Agenda displays the File box. 

3. Specify a file name by doing one of the following: 

• Type a file name (including a path if necessary) and press 


Press E3 (CHOICES) to see a list of files in the current directory. 
Highlight or type the name of the file you want to import and 
press ENTER. 
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4. Highlight Strip carriage returns, choose either No (default) or 
Yes, and press ENTER. 


No (default) Agenda keeps single carriage returns in the imported text. 

long or less. Agenda preserves the original formatting of the 
text. If the lines are longer than 79 characters, Agenda wraps 
each line at the nearest word before 79 characters and also 
wraps at each carriage return. 

Yes Agenda removes single carriage returns from the imported 

text This process allows Agenda to rewrap the text in the 
_note to lines that are 79 characters long. 


Agenda displays the imported text, which is now part of your 
Agenda file. 

Note If the file that you are importing is larger than 10,000 charac¬ 
ters (about seven pages of double-spaced text). Agenda 
imports only the first 10,000 characters. 


Exporting 
Information 
from Notes to 
Text Files 


You can also export some or all text in a note to an external text file. 
This lets you use information from the note in another product. For 
example, you might export customer information so that your man¬ 
agers can include it in a report they're preparing using a word 

Note When you export information from a note. Agenda places the 
information in an external text file, not a structured file. 
Agenda only places exported information in a structured file 
when you export multiple types of information (such as items 

exporting multiple types of information, see Chapter 23. 

To export text from a note to an external text file: 

1. In the note, press Flo (Menu) and select Export. 

Agenda displays the File box. 
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2. Specify a file name by doing one of the following: 

• Type a file name (including a path if necessary) and press 


• Press F3 (CHOICES) to see a list of files in the current directory. 
Highlight or type the name of the file to which you want to 
export information and press ENTER twice. 

If the file already exists. Agenda asks whether you want to 
append to or replace the current contents of the file. Choose 
Append (default) or Replace and press ENTER. 


Choice Result 


Append (default) Agenda adds the exported text to the end of the text 
originally in the text file. 

Replace Agenda deletes the original contents of the text file 

_before placing the exported text in the file._ 


Agenda copies the note text to the specified external file. The note 
text itself also remains in the Agenda file. 


About Note Files 


In Agenda, you can store notes in external note files and you can 
attach these external files to your Agenda file. When you store these 
notes in external note files. Agenda stores only the directory and file 
name in your Agenda file. The note text itself remains in the external 
note file, and does not increase the size of your Agenda file. 

Consider storing notes in external note files if you have 
• An ongoing exchange of information between Agenda and 
another application. Whenever you look at the note in Agenda, 
you see the most recently added information in the external note 


More than one Agenda file where you want to use the note. For 
example, you might reference a particular company in two sepa¬ 
rate Agenda files. If you keep additional information about that 
company in an external note file, you can easily add that 
information to your Agenda files. 
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You can either 

• Attach a new or existing note file to a note and then enter or edit 
the contents of the note 

• Store an existing note in an external note file (rather than storing it 
as part of your Agenda file) 

If you copy your Agenda file to another disk or computer, you 
should also copy any external files attached to that Agenda file — 
including the note files. To copy external files, use your operating 
system COPY command. (In Agenda, the File Maintenance 
MakeCopy command copies the attachments to external files, but 
does not copy the files themselves.) 

For information on printing a list of external files attached to an 
Agenda file, see Chapter 17. 


Attaching a You can attach a new or existing note file to an item or category: 

Note File to an 
Item or a Category 

• If you attach a new note file. Agenda displays a blank note. You 
can then type the note that you want to store in this external note 
file. 

• If you attach an existing note file. Agenda displays the contents of 
the file. You can then edit the contents of that note file. 

In either case, when you save the note. Agenda saves its changed 

contents in the note file. 

For information on sharing external note files on a Local Area 

Network (LAN), see Appendix F. 

You can attach a new or existing note file to an item when you are in 


• The Item Properties box 

You can attach a new or existing note file to a category when 


• The category manager 

• The Category Properties box 



Agenda displays the ] 

If the item or category already includes a non-externa] 
Agenda asks whether you want to delete the existing 
You must delete any ~' : - u -- 


2. Press ENTER. 


If the item or category already includes a non-external note. 
Agenda asks whether you want to delete the existing note text. 
You must delete any existing note text before you can attach a 
note file. Choose No (default) or Yes and press ENTER. 


Choice Result 

No (default: 

attaching a note file, and returns you to the Item Properties or 
Category Properties box. 

Yes 

attaching the note file. 

If the item or category already includes an external note file. 
Agenda asks whether you want to detach the existing note file. 
You must detach the existing note file before you can attach a 
new note file. Choose Yes (default) or No and press enter. 


Result 

Yes,default 

) Agenda detaches the existing note file and lets you continue 
attaching the note file. 

No 

Agenda does not detach the existing note file, ends the proce¬ 
dure for attaching a note file, and returns you to the Item 
Properties or Category Properties box. 


Agenda attaches the note file, if you choose to delete the existing note 
text, or detach an existing note file. 


Storing an 
Existing Note 
as a Note File 


You might create a note in your Agenda file and later decide that you 
want to store the note in a note file. This reduces the size of your 
Agenda file and also lets you use the note in other Agenda files. In 
this case, you export the contents of the note to a file and then attach 


To store an existing note in a note file: 

1. In the note, press no (MENU) and select Export. 
Agenda displays the File box. 






Notes 


2. Specify a file name by doing one of the following: 

• Type a file name (including a path if necessary) and press 
ENTER twice. 

• Press F3 (CHOICES) to see a list of files in the current directory. 
Highlight or type the name of the file to which you want to 
export information and press ENTER twice. 

If the file already exists. Agenda asks you whether you want to 
append to or replace the current contents of the file. Choose 
Append (default) or Replace and press ENTER. 


Choice Result 


Append (default) Agenda adds the exported text to the end of the text 
originally in the text file. 

Replace Agenda deletes the original contents of the text file 

_before placing the exported text in the file._ 


3. Press Fio (MENU) and select File Attach. 

Agenda asks you if you want to delete the existing note text. 
Choose Yes and press enter. 

4. Agenda displays the File box. 

5. Specify the file to use by doing one of the following: 

• Type the file name (including a path if necessary) and press 

• Press F3 (CHOICES) to see a list of files in the current directory. 
Highlight or type the name of the file and press ENTER. 

Agenda displays the contents of the attached note file. The name of 
the note file appears in the upper left comer of the screen. 



You can detach a note file from a note if you no longer want to use it. 
This procedure clears the attachment of the file from the note, but 
does not delete the note file from your disk. This means that you can 
still attach this note file to other items, categories, or to other Agenda 
files. 

To detach a note file: 

• In the note, press Flo (MENU) and select File Detach. 

Agenda detaches the note file from the item or category and displays 
a blank note screen. 


Erasing Note Files You can erase a note file from your disk if you no longer want to use 

this note file. You might erase the note file if, for example, the infor¬ 
mation in the note file becomes obsolete. 

Caution This procedure removes the attachment of the current note 
from the external note file, and also deletes this file from 
your disk. 

To erase a note file from your disk: 

1. In the note, press Flo (menu) and select File Erase. 

Agenda asks whether you want to delete the note file from the 
disk. 

2. Choose No (default) to retain the file on your disk or Yes to 
delete the file from the disk and press enter. 

If you choose Yes in Step 2, Agenda deletes the note file from 
your disk, removes the attachment to the file name, and displays 
a blank note. If you choose No, Agenda keeps the file on the disk 
and displays the note. 


Detaching Note 
Files 
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Chapter 13 

Manipulating Information 


Agenda lets you manipulate the items of information in your file to 
suit your needs. For example, to save time you can mark several 
items, then move or copy them as a group. 


In this Chapter 


This chapter describes how to 

• Perform tasks on more than one item 

• Move and copy items 

• Work with Done items 

• Make items dependent on other items 

• Prevent inherited items from appearing in a view 

• Permanently discard items from your file 

• Make item text into a new category 

• Display all the items in your file 


Performing Tasks on More than One Item 


You can perform many tasks on more than one item at a time. To do 
this, you mark the items that you want to work with. Marked items 
are items that have been selected for procedures such as moving, 
copying, removing, or discarding. 
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You use the F7 (mark) key to mark and unmark items. When you 
mark an item. Agenda changes the item tag to a diamond (♦). 





If you mark more than one item in a file, you can jump to the next 
marked item using the accelerator key alt-j. Agenda jumps to each 
marked item in the order in which you marked them. 

You can mark and unmark individual items or all items in a section. 


Marking and 
Unmarkina 
Individual Items 


To mark an item: 

1. Highlight the item you want to mark. 

Agenda marks the item and replaces the item tag with a diamond (♦). 
To unmark a marked item: 

• Highlight the item and press F7 (mark). 


Note Although the item is marked only m one section, some actions 
affect every appearance of that item in the file. For example, 
if you discard a marked item that appears in more than one 
section. Agenda discards that item from all sections in which 
it appears. 

You can mark or unmark individual items throughout your file. For 
example, you can mark items in different sections or views to discard 
them. You can also mark items in different views to display them 
together in one view. 


Marking and You can mark or unmark all items in a section at once. For example. 

Unmarking All you might do this to assign all of the items in a particular section to 

Items in a Section another category. 

To mark all items in a section: 

1. Highlight the section head for the items that you want to mark. 


Agenda replaces each item tag in that section with a diamond (♦). 

To unmark all of the items in a section: 

• Highlight the section head for the items that you want to unmark 
and press F7 (MARK). 



lark all items throughout your file: 


UnmarkinaAII Tounm 
Items in a File 

• Place the highlight anywhere in the view and press 
ALT-F7 (UNMKALL). 

Agenda unmarks all marked items throughout your file, replacing 
the diamonds with the item tags. 


Moving Items 


When you build your file, you probably enter items as they come to 
mind, without considering where they should be placed within the 


At some point, you may want to organize the items in your view. To 
organize the items in your view, you can: 

• Reposition items within a section 

• Move items from one section to another to assign them to a new 
category 

• Move marked items to a specific position 

• Sort items in a section (See Chapter 15.) 

When you move or copy items to another section, you change the 
assignment of those items. 


Repositioning You can change the position of one item at a time within a section. 

Items Within a You cannot change the position of items within a sorted section or 

Section within a section where the category used as a section head has child 

categories. 

To reposition items: 

1. Highlight the item whose position you want to change. 

2. Press I II) (menu) and select Item Reposition. 

3. Press t or l to position the item where you want to place it 
within the section and press ENTER. 

Agenda places the item in the new position within the section. The 
item is still assigned to the category used as the section head. 
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To move items to another section: 

1. Do one of the following: 

• Highlight the item that you want to move. 

• Mark the items that you want to move. 

2. Press alt-fio (MOVE). 

If there are marked items in the file. Agenda asks you if you want 
to move either the marked items or only the current item. 

If you have no marked items. Agenda displays the Move box and 
lists the sections in the view with the current section highlighted. 
Go to Step 4. 

3. Do one of the following: 

• Select Marked items and press enter to move all marked 


' Sekct^Current item and press enter to move only the high- 

Agenda displays the Move box and lists the sections in the view 
with the current section highlighted. 

4. Press t or 1 to highlight the section to which you want to move 
the itemfs) and press enter. 

Agenda places the highlighted or marked itemfs) at the bottom of the 
section that you specify and assigns them to the category used as the 
section head. If you move marked items. Agenda positions the items 
in the order in which you marked them. If the section is sorted. 
Agenda positions the items within the section according to the sort 
characteristics you specify. (See Chapter 15.) 

Moving Marked 
Items to a Specific 
Position 


You can move marked items to a specific position in a section. For 
example. Figure 13-4 shows three marked items in the No Priority 
Assigned section. You can use the following procedure to move 
these three items to the top of the Low section. 



5. Press enter to move the marked items to the section you selected 
in Step 2. 

Agenda inserts the marked items below the highlight. 
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Copying Items 


You can copy one or more item(s) from one section to another. When 
you copy items. Agenda assigns them to the category used as the new 
section head and leaves the items assigned to the category used as the 
original section head. 

When you copy an item, you place the same item in an additional 
section. If you edit the item in one section, the changes that you 
make are reflected anywhere else that the item appears. 

1. Do one of the following: 

• Highlight the item that you want to copy. 

• Mark the items that you want to copy. 

2. Press ALT-F9 (COPY). 

If there are marked items in the file. Agenda asks you if you want 
to copy the marked items or only the current item. 

If there are no marked items. Agenda displays the Copy box and 
lists the sections in the view with the current section highlighted. 
Go to Step 4. 

3. Do one of the following: 

• Select Marked items and press ENTER to move all marked 

• Select Current item and press enter to move only the high¬ 
lighted item. 

Agenda displays the Copy box and lists the sections in the view 
with the current section highlighted. 

4. Press T or J. to highlight the section to which you want to move 
the item(s) and press enter. 

Agenda places the highlighted or marked item(s) at the bottom of the 
section that you specify and assigns them to the category used as the 
section head. If you copy marked items. Agenda displays them in the 
order in which you marked them. 



Note If you copy an item from one mutually exclusive category to 
another. Agenda removes the item from the original section, 
because an item cannot be assigned to two mutually exclusive 
categories at the same time. (See Chapter 16.) 

another view, press ALT-H. 


Working with Done Items 


When you finish a task or an activity, you can designate an item as 
done. To designate an item as done, highlight the item and press 
F4 (DONE). Agenda assigns the item to the Done category with today's 
date and the current time and displays a symbol (!!) next to the item. 
For example, if you have an item, "Make plane reservations'', you can 
designate it as done after you make your travel arrangements. 

You can perform various tasks on Done items such as 

• Display all Done items 

• Prevent Done items from appearing in a view 

• Specify how to process all Done items 


Displaying All You can create a view to display all the items in a file that are desig- 

Done Items nated as done. For example, you can create a status report view that 

displays all your Done items. 

To create a view to display all Done items: 

• Press Flo (MENU) and select Utilities Show ItemsDone. 

Agenda creates a view called *Show View* with a section called 
*Show* to display all items in the current file that you designated as 
done (Figure 13-5). 
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To control how Agenda handles Done items throughout your file: 

1. Press Fio (menu) and select File Properties. 

Agenda displays the File Properties box. 

2. Highlight Global date settings and press space bar. 

Agenda displays the Global Date Settings box, which includes 
the Process Done items setting. This setting is described in the 
following section. 

3. Complete the Process Done items setting (and any other settings 
that display as a result of your Process Done items choice) and 
press enter twice. 


Process Done You use the Process Done items setting to control how Agenda han- 

Items Setting dies items that have been designated as done. 

Process Done items Choose how Agenda handles Done items. 


No action Agenda takes no action on Done items, 

(default) 


Export to Done 
file 


Agenda discards Done items and places them in the trash. 
Agenda displays the additional setting When. 

Agenda exports Done items to a Done file and discards 
them. Agenda displays the additional settings When and 


When Choose when Agenda should discard or export a Done item 
to a Done file. 
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(default) 




Agenda processes Done items when you designate the 
items as done or as soon as the system date matches the 


Agenda processes Done items when you quit Agenda, 
open a new file, or use the Print, System, or Launch 


End of day 


Agenda processes Done items when the system date 
changes to the next day's date. If the Done date includes 
a time. Agenda compares only the date portion of the 
Done date to the system date._ 


Agenda displays the When setting if you choose Discard or Export to 
Done file for Process Done items. 

Done file Specify the name of the structured file (a special file that 
Agenda can import) to which Agenda should save Done items. You 
can save items in a Done file so that you can import them into 
another Agenda file. For example, you can import items from your 
Done file into a file that you use for your weekly status reports. 

Agenda displays the Done file setting if you choose Export to Done 
file for Process Done items. 


Making Items Dependent on Other Items 


You can make an item dependent upon the completion of one or 
more other items. You might do this to focus your attention on spe¬ 
cific tasks before addressing others. Agenda displays a symbol (&) 
next to any dependent items in a view. 

Dependent items depend on the completion of one or more items. 
Prerequisite items must be completed before the dependent items. 
Figure 13-6 shows the relationship between prerequisite and 
dependent items. 
















3. Select one of the following commands: 


Command Result 

One Level Displays all items immediately dependent on, or prerequisite 
to, the current item 

All Levels Displays the entire chain of items that depend on, or are pre¬ 
requisite to, the current item 

Every Item Displays every item that has dependencies or prerequisites 

Agenda displays the *Show View* for the dependent or prerequisite 
item(s) that you specify. 

To return to the previous view: 


Hiding Inherited Items 


You can prevent certain items from appearing if they are duplicated 
in the same view. This feature allows you to avoid clutter on screen 
and see each item only once. 

For example, you create a parent category called Managers with the 
child categories Paul, Beth, and Bob. You create a view with sections 
for Managers, Paul, Beth, and Bob (Figure 13-9). 



Agenda displays the View 
2. Highlight Hide inherited i 
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Figure 13-10 Sections with inherited items hidden 

To redisplay the inherited items in a view: 

• Select No for the Hide inherited items setting in the 
View Properties box. 

For more information about inheritance, see Chapter 16. 


Permanently Discarding Items from Your File 


Agenda places discarded items in the trash, a temporary storage 
place. You can recover items that are in the trash. (See Chapter 3.) 
You can also select when Agenda empdes the trash for your file. 
Caution Once the trash is emptied, you can no longer recover the 
items it contained. The items are permanently discarded 
from the file. 

To specify when Agenda empties the trash: 

1. Press elo (menu) and select File Properties. 

Agenda displays the File Properties box. 






2. Highlight Empty trash and press F3 (CHOICES). 
Agenda displays the following choices: 




On demand Agenda empties the trash only when you select the 

Utilities Trash command 

When file is closed Agenda empties the trash when you close the file, 

quit Agenda, or select the Utilities Trash 
command 

End of day (default) Agenda empties the trash when the system date 

changes or when you select the Utilities Trash 


When item is discarded Agenda does not keep discarded items in the 


3. Highlight a choice and press enter twice. 

Agenda empties the trash of all discarded items according to the 
choice you specify. 

Tip To see all items in the trash, create a new section and use the 

Item Undisc command. Agenda displays the items in the trash 
in this section. You can move any items you want to keep to 
another section. 


Splitting One Item into Two Items 


You can split one item into two separate items. If an item consists of 
two sentences, you may later want to split the sentences into two 

To split an item into two separate items: 

1. Highlight the item and press F2 (edit). 

2. Do one of the following: 

• Move the cursor to where you want to split the item. 

• Mark the region of text that you want to make into a separate 
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3. Press ALT-F7 (SPLIT). 

Agenda splits the text into two items and places the cursor in the 

4. Press enter to complete the second item. 

Agenda assigns the new item to the category used as the section 


Making Item Text into a New Category 

You can make text in an item into a new category. This procedure is 
convenient when you type an item and realize that one of the words 
in it should be a category. 

To make item text into a new category: 

1. Highlight the item that includes the text you want to make into a 
new category. 

2. Press F2 (EDIT). 

3. Do one of the following: 

• Move the cursor to the beginning of the word in the item that 
you want to make into a category. 

• Mark the region of text that you want to make into a category. 

4. Press ALT-F2 (MAKECAT). 

Agenda asks you to specify the parent of the new category. 

5. Do one of the following: 

• Type the name of a new or existing category and press ENTER 

• Press F3 (choices), highlight a category, and then press 

SHIFT-ENTER. 

Agenda makes the text you specify into a category in the file. 

If you press F9 (CATMGR), Agenda displays the new category as a 
child of the parent category you specify. 




Displaying All Items in Your File 


You might want to scan a list of all items in your file. Agenda create: 
a view that contains all your items. 

To display all the items in your file: 

• Press Fio (MENU) and select Utilities Show Every. 

Agenda creates a *Show View* using the MAIN category. MAIN is 
the parent of all categories in a file and, therefore, inherits all the 
items in the file. 

Tip When you display a *Show View*, you can press ALT-F8 to 
return to the previous view. 
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Chapter 14 
Editing 


You enter information in an Agenda file by typing items, notes, and 
category names. You can also enter macros by typing them in a file. 
You can edit this information as you type it or at a later time. 

Agenda also lets you enter symbols and special characters that do not 
display on your keyboard. For example, you can enter the symbols 
for the Japanese yen (¥) or the British pound (£) as well as various 
accented characters (such as a or ii) in text that you type. 

You can change the attribute and/or font of regions of item, note, 
and header and footer text when you print. You do this by inserting 
markers in text. You can also insert markers that print information 
such as the view name or file description or that format your final 
printed page with page breaks or numbers. 


In this Chapter 


This chapter describes how to 

• Copy marked and unmarked text 

• Cut marked and unmarked text 

• Paste copied and cut text 

• Delete marked and unmarked text 

• Include special characters 

• Change the attribute and/or font for regions of item, note, and 
header and footer text from the current attribute and/or font 
when you print 




• Use markers to print specific information such as the view name, 
file description, or page numbers, and to force page breaks 
This chapter provides general information about editing. For more 
specific information about notes, see Chapter 12. For information 
about searching for text, see Chapter 15. 

This chapter also provides general information about editing macros 
since you can use most of the editing tasks described in this chapter 
to make changes to macros. 


Editing Tasks 


Whenever you type items, notes, category names, view names, or 
macros in Agenda, you can edit them. You can edit this information 
as you type it or after you've accepted it (for example, after you press 
enter to accept an item). You can 

• Copy text 

• Cut text 

• Paste text 

• Delete text 


Ed it Mode Before you can edit information in Agenda, you must be in Edit 

mode. As you type. Agenda automatically puts you in Edit mode. 
This means that you can edit information as you type. 

Once you accept what you type you must return to Edit mode before 

When you're in Edit mode. Agenda displays the edit indicator (EDIT) 
in the upper right comer of the screen. If you are editing an item, 
note, or header or footer text. Agenda also displays the highlighted 
character's font and attribute in the upper right corner of the screen. 
(See "Changing Text Attributes and Fonts" and "Using Special Mark¬ 
ers" later in this chapter.) 

Note Agenda displays the font of the highlighted character only if 
you have installed the preview and print features. (See Chap¬ 
ter 1 in Setting Up Agenda.) 





To edit most text (such as items, category names, and so forth): 

• Highlight the text you want to edit and press F2 (EDIT). 

• Highlight the item or category with the added note and press 
F5 (note) to display the note. 

To edit the name and/or contents of a macro: 

• In the macro manager, highlight the name of the macro you want 
to edit and press F2 (editmao. 

For more information about editing macros, see Chapter 1 in Working 
with Macros. 
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r category 
) the right 


In notes, insert tab stop for the 
number of spaces indicated in Tab 
size using the File Properties com- 

Complete current item or category shift-t. 
and move one column to the left (in 

Start a new line without completing alt-m 
the item or note; insert a carriage 



Press Fi (HELP) for comprehensive lists of the keys that you can use to 
edit items, notes, header and footer text, and category names, 


Marking Text 


You can mark specific regions of text to perform editing tasks such as 
copying and cutting text. For example, you might want to mark and 
copy the portion of an item that identifies the people on a project and 
paste this information mto another item that reminds you to contact 
all those concerned with the project. 

Note Marking text differs from marking items. (See Chapter 13.) 
You can perform the following tasks on marked text: 

• Copy 


• Change attributes and/or fonts for regions of text from the current 
attribute and/or font 
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• Split marked text in an item into two separate items (Chapter 13) 

• Make marked text into a new category (Chapter 13) 

• Make marked text in a note into an item (Chapter 12) 

• Append marked text in a note to an item (Chapter 12) 

To mark a specific region of text: 

1. In Edit mode, use the arrow keys to put the cursor at the begin¬ 
ning or end of the text that you want to mark. 

2. Press F7 (MARK) to anchor the region of text that you want to 

3. Use the arrow keys to highlight the region of text that you want 

To cancel the marking of text, press F7 (mark) in Step 3. 

Now you can perform any of the editing tasks described earlier in 
this section on the marked region of text. Procedures for these tasks 
are provided in the following sections. 


Copying Text 


You can copy marked or unmarked text. Agenda temporarily stores 
copied text. You can then paste this text elsewhere in the current file 
or in another Agenda file that you use during the same Agenda 


For example, you might want to copy the portion of a note that iden¬ 
tifies the names of your management team and paste this text into an 
item that reminds you to write a memo to all management team 
members. 

Caution When you quit Agenda, the stored text is deleted. 



To copy text: 

1. In Edit mode, do one of the following: 

• Use the arrow keys to put the cursor at the beginning of the 
text that you want to copy. 

• Mark the region of text that you want to copy. 

2. Press F3 (COPY). 

If there is no marked text. Agenda asks what you want to copy. 
Select your choice and press enter. (If the cursor is not on a 
word, choosing Word copies the word before the cursor.) 

Agenda temporarily stores a copy of the text. You can now paste this 
text elsewhere in this file or in another Agenda file that you use dur¬ 
ing the same Agenda session. (See "Pasting Text" later in this chap¬ 
ter.) 


Cutting Text 


You can cut marked or unmarked text. Agenda removes the text 
from where you cut it and temporarily stores it. You can then paste 
this text elsewhere in the current file or in another Agenda file that 
you use during the same Agenda session. 

For example, you might want to cut the portion of text from a note 
that identifies prospective clients and paste it into another note. 
Caution When you quit Agenda, the stored text is deleted. 


1. In Edit mode, do one of the following: 

• Use the arrow keys to put the cursor at the beginning of the 

• Mark the region of text that you want to cut. 

2. Press F4 (CUT). 

If there is no marked text. Agenda asks what you want to cut. 
Select your choice and press enter. (If the cursor is not on a 
word, choosing Word cute the word before the cursor.) 
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Agenda removes the cut text and temporarily stores it. You can now 
paste this text elsewhere in this file or in another Agenda file that you 
use during the same Agenda session. (See "Pasting Text" in the fol¬ 
lowing section.) 


Pasting Text 


When you cut or copy text. Agenda temporarily stores this text. You 
can then paste this text in the current file or in another Agenda file 
that you use during the same Agenda session. 

Only one piece of cut or copied text is stored at a time. If you copy or 
cut another piece of text. Agenda replaces whatever text was pre¬ 
viously stored with the new text. 

Caution When you quit Agenda the stored text is deleted. 

To paste copied or cut text: 

1. In Edit mode, use the arrow keys to put the cursor at the position 
where you want to paste the text. 

2. Press F2 (PASTE). 

Agenda places the cut or copied text at the cursor position. 

Note After pasting text, this text is still stored. This means you can 
paste it elsewhere again. Agenda continues to store this text 
until you cut or copy other text or quit Agenda. 


Deleting Text 


You can delete marked or unmarked text without temporarily storing 
it. For example, you might delete all text from a note that you no 
longer want to keep. 





1. In Edit mode, do one of the following: 

• Use the arrow keys to put the cursor at the beginning of the 
text that you want to delete. 

• Mark the region of text that you want to delete. 

2. Press ALT-F4 (DELETE). 

If there is no marked text. Agenda asks what you want to delete. 
Select your choice and press enter. (If the cursor is not on a 
word, choosing Word deletes the word before the cursor.) 
Agenda deletes the text that you specify. 


Including Special Characters 


Agenda lets you enter characters in text that are not displayed on 
your keyboard. For example, you can enter the symbols for the 
Japanese yen (¥) or the British pound (£) as well as various accented 
characters (such as a or ii) in text that you type. 

Typically, each special character is created using two keys called a 
compose sequence. 

To enter a special character: 

1. In Edit mode, press ALT-F1 (COMPOSE). 

2. Type the compose sequence for the character that you want to 
enter. For example, press L and - (hyphen) to display a British 
pound symbol (£). (For a comprehensive list of compose 
sequences, see Appendix D.) 


Changing Text Attributes and Fonts 


A font is a typeface of a particular size. Times Roman 10 point, 
Roman 12 pitch, and Courier 10 point are all different fonts. An 
attribute is a characteristic of printed text. Bold, italic, and normal 
are all different attributes. (For more information about fonts and 
attributes, see Chapter 17.) 
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You can change the attribute and/or font for regions of item, note, 
and header and footer text from the current attribute and/or font 
when you print. You might want to do this to add emphasis to a 
particular word or phrase. 

You can change 

• The attribute, including specifying combinations of attributes 
For example, if the attribute for the item "Call Nina tomorrow" is 
normal, you can change the attribute for the word "tomorrow" so 
that it prints in italic — "Call Nina tomorrow". 

To add further emphasis to a word, you can also specify combina¬ 
tions of attributes. You can add further emphasis to the word 
"tomorrow" in the above item ("Call Nina tomorrow") so that it 
prints in italic and bold — "Call Nina tomorrow". 

For example, if the font for the item "Call Nina tomorrow" is Pala- 
tino 10 point, you can change the font for the word "tomorrow" to 
Helvetica 12 point so that it prints in a larger font for emphasis 
—"Call Nina tomorrow". 

• Both the attribute and font 


For example, if the attribute for the item "Call Nina tomorrow" is 
normal and the font is Palatino 10 point, you can change both the 
attribute and font for the word "tomorrow" (in this case, to bold, 
Helvetica 12 point) — "Call Nina tomorrow”. 


i change attributes and/or fonts for regions of text by inserting 


You can insert markers in item, note, and header and footer text. 
Markers take effect when you print your file; they have no effect on 
how text displays on your screen. The sections that follow describe 
how to work with markers. 

Note You cannot insert markers in macros, category names, view 
names, or settings in boxes. 


Understandin g You can insert markers to print regions of item, note, and header and 

Text Attribute footer text with attributes and/or fonts different from the current text 

and Font Markers attribute and/or font. 

Agenda interprets the "current" text attribute or font as that attribute 
or font specified by the immediately preceding marker. If no markers 




Figure 14-1 Print Layout box for selecting default fonts and 


In Figure 14-2, the current attribute and font for the item "It is both 
critical and essential that we curtail expenses” is normal. Times 
Roman 12.0 point This attribute and font were selected using the 
Print Layout command. (In Edit mode. Agenda displays the current 
attribute (Normal) and font (Times Roman 12.0 point) for the high¬ 
lighted character in the upper right corner of the screen.) 

Note Agenda displays the font of the highlighted character only if 
you have installed the preview and print features. (See Chap¬ 
ter 1 in Setting Up Agenda .) 
















the marker and press F6 (MARKER). 

• Mark the region of text to which you want to apply the new 


Agenda displays the Marker box (14-6). 

If you installed the print and preview features, the top of the 
Marker box displays the current printer, page orientation, and 
title font for the highlighted text. It always displays the current 
attribute for the highlighted text. You cannot change this infor- 







3. Highlight Attribute and press F3 (CHOICES) to display the list of 
attributes. Unless the cursor is already on an attribute marker. 
Agenda displays this list with an x beside None. 

4. Highlight the attribute that you want to use and press SPACE bar. 
Select as many attributes (that don't conflict) as you want. 


Agenda displays an x beside each attribute that you choose. (To 
remove an x, highlight the attribute that you want to remove and 
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Figure 14-8 Printed view of information with attributes 
from Figure 14-7 

Chang i ng Fonts You use font markers to print a specific region of text with fonts 

different from the current font. You can insert font markers in item, 
note, and header and footer text. You can also apply fonts to marked 

Font markers let you customize your printed page. For example, you 
can insert font markers in your header Status Report: Week of 
11/5/90 to 11/12/90 to print the words "Status Report" in a larger 
font than the current header font (for example. Status Report: Week 
of 11/5/90 to 11/12/90). 

With font markers you replace the current font for specific text with a 
different font. For example, if the current font for item text is Times 
Roman 12.0 point and you insert a marker for Helvetica 10.0 point, all 
text following the marker in the item prints in a Helvetica 10.0 point 

Notes You cannot insert font markers unless you have installed the 
preview and print features. See Chapter 1 in Setting Up 
Agenda. 














nth font markers 










Agenda displays the Marker box. 

3. Highlight Special and press F3 (choices) to display the list of 
special markers. Special markers are described in the following 

4. Highlight the special marker you want to insert and press ENTER 

Agenda inserts the marker you select at the current cursor position. 
Note When you display the Marker box. Attribute, Font, and 

Special each display with the default None. This means that 
no marker is inserted at the currently-highlighted character. 
If the cursor is on a marker, the name of the marker displays 
in the Marker box beside the appropriate setting. 

Figure 14-12 shows the Header and Footer box with the default 
special markers. In this example, markers display on the screen in 
long form. (See "Displaying Markers" later in this chapter.) 
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Special Marker 
Descriptions 


You use special markers to include specific information, such as the 
date or time, when you print your file. Special markers also let you 
format your page, for example, by forcing page breaks or printing 
page numbers. You can insert special markers in item, note, and 
header and footer text. 

Date Print the system date when the file is printed in the default 
format that you specify using the File Properties command. 
(Complete the Display format setting under Global date settings.) 
Description Print the description of the current Agenda file. This is 
the description you specify for File Description using the File 
Properties command or in the New File box when you create the file. 
File Name Print the name of the current Agenda file, without the 

Page Break Force a page break. You can only insert this special 

Page Number Print the page number. You can only insert this 
special marker in header and footer text. 

Path Name Print the path for the current file, without the file name. 
Printer Code Use a printer control sequence to perform a particular 
print function. 

Agenda displays the Sequence setting in the Marker box when you 
choose Printer Code. See "Specifying Printer Control Sequences" 
later in this chapter. 

Time Print the system time when the file is printed in the default 
format that you specify using the File Properties command. 
(Complete Display format under Global date settings.) 

View Name Print the name of the current or last-displayed view. 
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Specif ying Printer If you insert the Printer Code special marker. Agenda displays the 

Control Sequences Sequence setting in the Marker box. 

Many specialized printing tasks, such as those to change print colors 
for color printers or to change to condensed print, are controlled by 
sending special printer codes to your printer. You can insert these 
codes into item, note, and header and footer text using a Printer code 
marker. You send printer codes to your printer by entering one or 
more control sequences. A control sequence is a sequence of ASCII 



Each printer recognizes its own set of control sequences. (For the 
control sequences for the tasks that your printer can perform, see 
your printer manual.) 

Some control sequences may contain characters that you cannot type 
directly (for example, ESC or NULL). To specify these control 
sequences, type a backslash (\), followed by the three-digit decimal 
number that represents the ASCII code for that character. For exam¬ 
ple, the printer manual for the Epson® EX-86e® identifies the control 
sequence for printing in condensed mode as ESC SI. 

You enter the control sequence in the Sequence setting in the Marker 
box. For the above example, since you cannot type ESC or SI, enter a 
backslash (\) followed by the three-digit decimal control sequence 
identified in the printer manual for each of these characters. Enter 
\027\015. 

To specify a printer code sequence: 

1. Follow Steps 1 through 3 in "Using Special Markers" to insert the 
printer code special marker. 

2. Highlight Printer Code and press ENTER. 

Agenda displays Printer Code in the Special setting. It also dis¬ 
plays the setting Sequence. 

3. Highlight Sequence and enter the appropriate printer control 
sequence for the task you want your printer to perform. 

4. Press enter twice. 

Agenda sends the printer code sequence you specify to your printer 
when you print. 


Displaying Markers 


You can choose how to display markers on the screen. This proce¬ 
dure controls how all markers (attribute, font, and special markers) 
display on the screen. The procedure has no effect on printed output. 
To select how to display markers: 

1. From a view, press Flo (MENU) and select Utilities Customize. 
Agenda displays the Utilities Customize box. 



Editing 14-27 


2. Highlight Text marker display and press F3 (CHOICES). 


Hidden Does not display markers on the screen 

Diamond (♦) (default) Displays the diamond character (♦) 

Long Displays, in brackets ([ ]), an abbreviated 

3. Highlight your choice and press enter twice. 

Whenever you insert a marker in text. Agenda displays the marker 
according to what you specify. 


Deleting Markers 


You can delete attribute, font, and/or special markers just as you can 
delete any other character in Agenda. 

To delete a marker: 


1. Do one of the following: 

• To delete a marker in item text, highlight the item and press 


• To delete a marker in note text, highlight the item or category 
with the attached note and press F5 (NOTE). 

• To delete a marker in header or footer text, press Flo (menu) 
and select Print Layout. 

Highlight Header/Footer and press SPACE BAR. 

Highlight the header or footer line that you want to edit and 
press F2 (EDIT). 

2. Use the arrow keys to place the cursor on the marker that you 
want to delete and press DEL. (You can also place the cursor at 
the position after the marker and press BACK space). 

Agenda asks if you want to delete the marker. 

3. Choose Yes and press enter. 


Agenda deletes the marker you specify. 



Chapter 15 

Searching and Sorting 


Agenda provides ways for you to search for items (or notes) that con¬ 
tain specific text. Agenda also lets you sort items, section heads. 


In this Chapter 

This chapter describes how to 

• Search for items in the current view or file 

• Search and replace text in a note 

• Sort items in one or all sections in a view 

• Sort section heads in a view 

• Sort categories in the category hierarchy 

• Sort views in the view manager 

About Searching 


In a typical day, you search for many things. You may look for a 
phone message on your desk, or a note you wrote to remind yourself 
to review a proposal. Or you may check your address file or phone 
book to look up an address or phone number. 

Agenda makes it easy to search through your file for items. If there 
are only a few items in a view, you can just glance at the view. How¬ 
ever, if there are many items, it's no longer possible to easily find an 
item by just glancing at the view. Agenda lets you locate items that 
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Searching and Sorting 


contain specific text. Text can be words, phrases, parts of words, or 
letters or numbers. You can search for items in the current view or in 
the entire file. You can also search for text in a note and then replace 
the text with different text. 

The following sections discuss how to: 

• Search for items in the current view that contain specific text 
For example, you might want to look for all items in the current 
view that contain the word ’budget". When you search for items 
in the current view. Agenda highlights the first item that contains 
"budget”. As you continue the search. Agenda then highlights the 
next item that contains the text. 

• Search for items in the current file that contain specific text 

For example, you might want to display all items in the entire file 
that contain the word "budget”. Agenda creates a view that dis¬ 
plays all items in the current file that contain "budget”. 

• Search for and replace text in a note 

For example, you might want to search a note for the text "J & D 
Corporation" so that you can replace every occurrence with "John¬ 
son and Davis Corporation". 


Searching for Items in the Current View 


You can search for all items in a view that contain specific text. You 
can also mark the items and perform tasks on the group of items. (See 
Chapter 3.) For example, you can mark all items that contain the 
word "phone" and assign them to a new category. Follow up. 

To search for items in the current view that contain specific text: 

1. In a view, press ALT-F6 (SEARCH). 

Agenda displays the Search box. The settings are described in 
the following section. 

2. Complete the settings and press ENTER to start the search. 

Agenda highlights the first item that includes the text you 
entered. (Agenda displays a message if it does not find a match 
with the text.) 
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Agenda displays a message that describes how to continue the 

3. Do one of the following: 

■ Press alt-n to continue to the next match. 

• Press ALT-P to go to the previous match. 

• Press F7 (MARK) to mark the highlighted item. 

Agenda displays a message after the last occurrence of the text. 

4. Press enter or ESC to end the search. 


Search Settings You use the Search settings to indicate the specific text you want to 
search for and how Agenda should perform the search. 

Search for Specify the text that you want to search for (maximum of 
60 characters). 

You can use any of the characters (’?;,-! \ () A ) you use when you 
establish text conditions. (See Chapter 19.) For example, you can use 
an asterisk (*) to match characters in the item (or note) text. ("Pat*" 
matches "Pat”, "Patty", or "Patricia".) 

To search for a phrase (more than one word), enclose the phrase in 
parentheses. For example, to search for the phrase "Human 
Resources Department", enclose it in parentheses (Human Resources 
Department). 

Match on Specify where Agenda should search for the text. 


Choice _ Result 


Item text (default) Agenda searches for the text in items only. 

contains the text. Agenda highlights the item with the 

Both item & note Agenda searches for the text in both items and notes. If a 
note contains the text. Agenda highlights the item with 




15-4 Searching and Sorting 


Direction Specify the direction irn 
the text. 


vhich Agenda should i 




Forward (default) 


t the highlight and searches forward 
t the highlight and searches back- 


Search from beginning Agenda starts at the beginning of the view and 


Ignore case Specify whether Agenda should ignore differences in 
upper and lowercase when it matches the text. The choices are Yes 
(default) and No. 


Searching for Items in the Current File 


You may want to search the entire file, instead of just one view, to 
locate all items in the file that contain specific text. When you search 
the current file. Agenda creates a view called *Show View* to display 
all the items that contain the text that you specify. 

To search for all items in a file that contain specific text: 

1. Press Fic (menu) and select Utilities Show Match. 

Agenda displays the Show Match box. The settings are described 
in the following section. 

2. Complete the settings and press enter. 

Agenda displays the *Show View* with the items that contain the text 
that you specify. 

To return to the view that you were in: 

• Press ALT-F8 (LAST VW). 
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Show Match You use the Show Match settings to indicate what you want to search 

Setti n g S for and how Agenda should perform the search. 

Search for Specify the text that you want to search for (maximum of 
60 characters). 

You can use any of the characters (* ?;, ~ ! \ () A ) you use when you 
establish text conditions. (See Chapter 19.) For example, you can use 
an asterisk (*) to match characters in item (or note) text. ("Pat*" 
matches "Pat", "Patty", or "Patrida".) 

To search for a phrase (more than one word), enclose the phrase in 
parentheses. For example, to search for the phrase "Human 
Resources Department", enclose it in parentheses (Human Resources 
Department). 

Match on Specify where Agenda should search for the text. 


Choice Result 


Item text (default) Agenda searches for the text in items only. 

Note text Agenda searches for the text in notes only. If a note 

contains the text. Agenda highlights the item with the 


Both item & note Agenda searches for the text in both items and notes. If a 
note contains the text. Agenda highlights the item with 
_the attached note._ 


Ignore case Spedfy whether Agenda should ignore differences in 
upper and lowercase when it matches the text. The choices are Yes 
(default) and No. 


Example of 
Searching for 
Items in the 
Current File 


You want to find all items in the current file that contain "budget" in 
the text of an item. You only want to locate the items where the text 
appears in lowercase letters. The following table shows the 
appropriate choices. 


Search for 
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Searching and Replacing Text in a Note 


You can search for specific text in a particular note. You can also 
replace that text with a new word, phrase, or sequence of characters. 
The note can be attached to an item or a category. 

To search for and replace text in a note: 

1. Press F5 (NOTE) to display the note. 

2. Press ALT-F6 (SEARCH). 

Agenda displays the Search/Replace box. The settings are 
described in the following section. 

3. Complete the settings and press enter to start the search. 

Use the Search/Replace settings to search only, or to search and 


If you search for text but choose not to replace it. Agenda moves the 
cursor to the first occurrence of the text. To continue to search for the 
next occurrence of the text, press ALT-S. Agenda beeps when there 
are no more occurrences of the text. 


If you search i 
all occurrence 
specify. 


%nd replace text. Agenda replaces the first occurrence (or 
s, if you want) of the text with the new text that you 


Search/Replace 

Settings 


You use the Search/Replace settings to specify the text that want you 
to search for (and, if you choose to replace it, the new text). 

Search for Specify the text that you want to search for or replace 
(maximum of 25 characters). 

Replace text Specify whether you want Agenda to replace the text 
with new text. The choices are No (default) and Yes. 

If you choose Yes, Agenda displays the additional settings Replace 
with. Global replacement, and Confirm replacement. 

Replace with Specify the text that you want Agenda to substitute 
for the existing text (maximum of 25 characters). 

Agenda displays the Replace with setting if you choose Yes for 
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Direction Specify the direction in which Agenda should search for 
the text. The choices are Forward (default) and Backward. 

Ignore case Specify whether Agenda should ignore differences in 
upper and lowercase when it matches the text. The choices are Yes 
(default) and No. 

Global replacement Specify whether Agenda should replace only 
the first occurrence of the text or all occurrences of the text. The 
choices are No (default) and Yes. 

Agenda displays the Global replacement setting if you choose Yes 
for Replace text. 

Confirm replacement Specify whether Agenda should prompt you 
to confirm that you want to replace an occurrence of the text before 
Agenda replaces it. The choices are Yes (default) and No. 

Agenda displays the Confirm replacement setting if you choose Yes 
for Replace text. 


Example of 
Searching and 
Replacing Text 
in a Note 


You want to find all occurrences of "Personnel Division” in a note and 
replace them with "Human Resources". You don't care whether Per¬ 
sonnel Division" is in upper or lowercase. (For example, "personnel 
division", "PERSONNEL DIVISION", and "Personnel Division" are 
all the same.) Before Agenda replaces the text, you want to look at 
the existing text and confirm that you actually want it replaced. 

The following table shows the appropriate choices. 


Search for 
Replace text 
Replace with 
Direction 


Global replacement 


s i«qfr _ 

Personnel Division 

Human Resources 
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About Sorting 


Sorting helps you organize your information. For example, if you 
have a stack of twenty phone messages on your desk, you might sort 
them according to the date you should return the calls. Just as manu¬ 
ally sorting the numerous messages and pieces of paper on your desk 
makes it easier for you to plan and organize your information, using 
Agenda to sort your information helps you get organized. 

The rest of this chapter describes how to sort: 

• Items in all sections in a view, or in just one section in a view 
For example, you can sort items in all sections in a view by the 
When date assigned to each item. 

You can specify how Agenda sorts items in all sections in a view. 
However, you can also override the default if you want Agenda to 
sort items in one section differently from all other sections. 

• Sections in a view 

For example, if you have a Company view that contains sections 
for each company name, you can sort the sections alphabetically. 

• Categories in the category hierarchy 

For example, if you have categories for each state in the United 
States, you can sort the categories alphabetically. 

• Views in the view manager 

For example, if you create many views in your file, you can sort 
them so they display in alphabetical order in the view manager. 

About Sorting You can sort items in sections by any of the following three 

Items characteristics: 

• The text of the item 

• A category 

• A category note 
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Items sorted by the text of the item 

Figure 15-1 shows items before you sort them alphabetically by the 
first letter in each item. 









» by the category note s 


ched to catego- 
ntains zip code 
►o that Agenda 


by Category Note" later in this chapter 
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Agenda first sorts the items by Priority (the primary sort key). When 
Agenda finds items with the same priority, it sorts these items by the 
When date (the secondary sort key). 

Default Sort You can specify how Agenda sorts items in all sections in a view or in 

Settings for just one section in a view. 

Items 


• You specify how Agenda sorts items in all sections in a view using 
the View Properties command. The selections you make with the 
View Properties command serve as defaults for the sort settings 
for all sections in the view. (See the following section.) 

• You specify how Agenda sorts items in just one section in a view 
using the View Section Properties command. When you specify 
how Agenda sorts items in the current section only, you override 
the default settings for the view. (See "Sorting Items in One 
Section in a View" later in this chapter.) 

For example, you have a view with four sections. Calls, Meetings, 
Correspondence, and Ideas. You want Agenda to sort the items in 
the first three sections by the Priority category. You want Agenda to 
sort the items in the Ideas section by the Project category to which 
you assign them. 

First, use the View Properties command to specify the sort settings 
for all sections in the current view. In this case, you specify you want 
items in all sections in the view sorted by Priority. Second, use the 
View Section Properties command to specify how you want Agenda 
to sort items in the Ideas section. Agenda sorts the items in all 
sections in the view by Priority, except for the Ideas section, which 
Agenda sorts by Project. 


Sorting Items in All Sections in a View 

1. Press F10 (MENU) and select View Properties. 
Agenda displays the View Properties box. 



Figure 15-7 Item Sorting in All Sections box 


Item Sorting in All You use the Item Sorting in All Sections settings to specify what items 
Sections Settings you want to sort and how you want to sort them. 

You can specify a primary sort key and a secondary sort key if you 
want to sort by two characteristics. 

Sort new items Specify when you want to re-sort the items to incor¬ 
porate new items added to the section. Agenda always sorts the 
section once, after you complete the Item Sorting in All Sections 
settings. 










I Sorting 



Regardle 
on the cu 

Sort on 


!SS of what your choice is, you can always re-sort items based 
trrent sort settings by pressing ALT-S. 

Specify the characteristic by which Agenda should sort the 


Choice 

Result 

None (default) 

Agenda returns the items to the order in which they were 
originally entered. Agenda cancels the sorting of new 

Item text 

Agenda sorts alphabetically based on the first letter of the 
item text. Agenda displays the additional settings Order 
and Sort n/a's. 

Category 

Agenda sorts based on the children of the category that 
you specify, using the order that you specify for the 
Sequence setting. Agenda displays the additional settings 
Order, Category, and Sort n/a's. Agenda displays the set¬ 
ting Sequence if you specify a standard category by which 

Category note 

Agenda sorts based on a line from the notes attached to 
children of the category that you specify. Agenda displays 
the additional settings Order, Category, Sequence, Sort 
n/a's, and Line number. 


Line number Specify the line from the note on which Agenda 
should sort. The default is 1. 

Agenda displays the Line number setting if you choose Category 
note for Sort on. 
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Order Specify the direction for the sort. 


Ascending (default) Agenda sorts in ascending category (top to bottom), 
alphabetic (A-Z), numeric (0-9), or date (Jan-Dec) 


S alphabetic (Z-A), numeric (9-0), or dbteT^cJm) tOP> ’ 


Agenda displays the Order setting if you choose Item text. Category, 
or Category note for Sort on. 

Sort n/a’s Specify where Agenda places items sorted on category, 
category note, or item text for which a value is not available. 

• If you sort by category, but the item is not assigned to a child of the 
specified category. Agenda interprets the item as not available for 
the purposes of the sort. 

For example, if you sort by the category Company but the item 
"Get billing invoices from ABC Corporation" is not assigned to a 
child of Company, Agenda considers the item not available. 

• If you sort by category note, but there is no category note for the 
child of the category by which you sort the items (or no text on the 
line number that you specify). Agenda interprets the item as not 
available for the purposes of the sort. 

• If you sort by item text but you leave the item blank. Agenda inter¬ 
prets the item as not available or having no value. 


Choke _ Result 


Bottom of section (default) Agenda puts items sorted on category, cate¬ 
gory note, or item text that are not available at 
the bottom of the section. 

gory note, or item text that are not available at 


For example, you sort items by the When category and the item 
"Think about sales proposal" is not assigned to the When category. 
By default, when Agenda sorts the items. Agenda places "Think 
about sales proposal" at the bottom of the section. 
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Category Specify the name of the category family by which you 
want to sort. If you sort by a category note, specify the parent of the 
category family that has the attached note. 

To select a category, do one of the following: 

• Type the name of a category. 

• Press F3 (CHOICES) and select an existing categoiy from the 
category hierarchy. 

Agenda displays the Category setting if you choose Category or 
Categoiy note for Sort on. 

Sequence Specify how you want Agenda to sort. 


Category hierarchy (default) Agenda sorts in the order in which the child 

For example, you sort by Priority and the chil¬ 
dren of Priority display in the category hierar¬ 
chy in the order High, Medium, and Low. 
Agenda puts all items assigned to High at the 
top of the section and all items assigned to 
Low at the bottom of the section. 

Alphabetic Agenda sorts in alphabetic order. It you sort 

by category. Agenda sorts in the alphabetic 
order of the child categories. If you sort by 
category note. Agenda sorts in the alphabetic 
order of the text in the category note. 

Numeric Agenda sorts in numeric order. If you sort by 

category. Agenda sorts in the numeric order 
of the child categories. For example. Agenda 
places items assigned to the category 
10-Series before items assigned to the 
category 300-Series. If you sort by category 

text in the category note. 

Date Agenda sorts in chronological order. If you 

sort by category. Agenda sorts in the chrono¬ 
logical order of the child categories. For 
example. Agenda places items assigned to the 
category January 15,1991 before items 
assigned to the categoiy April 15,1991. If you 
sort by category note. Agenda sorts in the 
chronological order of the text in the category 
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Agenda displays the Sequence setting if either of the following is 

• You choose Category for Sort on and you specify a standard 
category for the Category setting. 

• You choose Category note for Sort on. 

Example Of Sorting You want to sort items that track invoice information by the comp 
Items by Category ies to which they are assigned (Figure 15-8) and you want Agenda 
re-sort the items whenever you enter an item. 



Figure 15-8 Items sorted by the Company category 

The following table shows the choices you make to sort items as 
shown in Figure 15-8. 


For this setting Specify 

Sort new items When item is entered 


Order Ascending 

Sort n/a's Bottom of section 

Category Company 

Sequence Alphabetic 
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The following table shows the choices you make to sort items as 
shown in Figure 15-10. 


For this setting Specify 


Sortn/a's 

Category 

Sequence 


On leaving a sectio 

3 

Ascending 
Bottom of section 

Alphabetic 


Sorting Items in One Section in a View 


To sort items in one section in a view: 

1. Move the highlight anywhere in the section that you want to sort. 

2. Press FID (MENU) and select View Section Properties. 

Agenda displays the Section Properties box. 

3. Highlight Item sorting and press SPACE bar. 

Agenda displays the Item Sorting in Current Section box. The 
settings are summarized in the following section. 

4. Complete the settings and press ENTER twice. 

Agenda sorts the items in the section. 


Item Sorting in You use the Item Sorting in Current Section settings to specify the 

Current Section items you want to sort and how you want to sort them in the current 
Settings section. 

The Item Sorting in Current Section box has the same settings as the 
Item Sorting in All Sections box. Note, however, that the choices you 
select for the Item Sorting in All Sections settings serve as defaults for 
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The words "View default" in the Item Sorting in Current Section box 
'^AUSectf A te* da USeS - he dcfaults you chose in the Item Sorting 
these defaults and sort items in the current section differently than 
items in all other sections in the view, specify other choices for the 
Item Sorting in Current Section settings. 

To return to the View default settings: 

• In the Item Sorting in Current Section box, press alt-fs (dfltall). 
The settings are described in "Item Sorting in All Sections Settings” 
earlier in this chapter. The following table summarizes these settings. 


Setting 

Choices 

Sort new items 

On leaving a section (default). When item is entered. 


None (default). Item text. Category, Category note 

Line number 

1 (default). Any number 

Order 

Ascending (default). Descending 

Sort n/a's 

Bottom of section (default). Top of section 

Category 

Any existing category 

Sequence 

Category hierarchy (default). Alphabetic, Numeric, Date 


Sorting Section Heads in a View 


You can sort the order that sections display in a view to organize the 
view. Agenda sorts the sections based on the names of the section 
heads. 

For example, you have a District Office view that contains a section 
for each district office in your company. You can sort the section 
heads alphabetically by the names of the district offices. 

To sort all section heads in a view: 

1. Press Flo (MENU) and select View Properties. 

Agenda displays the View Properties box. 
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Sorting Categories in the Ca tegory Hierarchy 

You can sort categories in the category hierarchy to organize a lone 
list of categories. 6 

For example, you have a long list of cities (each of which is a cate¬ 
gory) that display in no particular order in the category hierarchy. 
You can sort these categories alphabetically to make it easier to scan 

To sort categories in the category hierarchy: 

1. Press F9 (CAT MGR). 

Agenda displays the category manager. 

2. Highlight the parent of the family whose child categories you 

3. Press alt-fs (sort). 

Agenda prompts you to confirm that you want to sort the catego- 

4. Press ENTER to confirm that you want to sort the 

categories. 

Agenda sorts the child categories alphabetically by the category 






Chapter 16 

Working with the Category Hierarchy 


The category hierarchy lists the categories in your file and shows you 
how these categories relate to each other. 

Agenda builds the category hierarchy as you enter categories in a 
view. You can modify the hierarchy by adding categories and dis¬ 
carding categories and by changing the relationship of categories to 


In this Chapter 


This chapter describes 

• How categories are related 

• How to display the category hierarchy and category properties 

• How to move around in the category hierarchy 

• How to change the structure of your file by adding, discarding, 
rearranging, and sorting categories 

• How to make categories mutually exclusive 

• How to promote and demote categories 

Chapter 3 describes how to assign items to categories. Chapter 4 
describes how categories are related and how to make, display, break, 
and modify assignments to categories. 
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About the Category Hierarchy 


Unlike traditional database programs. Agenda does not require you 
to define the structure of your information before you enter it. As 
you enter categories in a view. Agenda automatically builds relation¬ 
ships between them. You can display the category hierarchy and see 
how categories are related. You can also build or modify the category 
hierarchy yourself. 

Figure 16-1 shows a view consisting of items and categories. Figure 
16-2 shows how the category hierarchy reflects the categories entered 



Figure 16-2 Category hierarchy built from the categories in 
the view in Figure 16-1 
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When a category appears as a section head in a view, you see both the 
items that are directly assigned to the category and the items inher¬ 
ited by the category. You can decide instead to display only those 
items directly assigned to each category. The Hide inherited items 
setting under the View Properties command controls this feature. 
(See Chapter 13.) 

Because an ancestor inherits items assigned to its descendents, 
Agenda does not let you assign an item directly to both an ancestor 
and its descendent. If you directly assign to an ancestor an item that 
is already assigned to its descendent. Agenda breaks the assignment 
to the descendent. 

Note Because the MAIN category is the ancestor of all categories in 
the file, all items in the file are assigned to MAIN through 
inheritance. (You can also assign items directly to MAIN, 
although this removes the items from any other category to 
which they may be assigned.) The Utilities Show Every com¬ 
mand creates a view with MAIN as the section head and dis¬ 
plays all the items in your file. 


Displaying the Category Hierarchy 


You can display and work with the entire category hierarchy in the 
category manager. 

To display the category manager when you are in a view: 

• Press F9 (CAT MGR). 

You can remove the key map at the bottom of the screen and display 
more of the category hierarchy by pressing ALT-K. You can restore 
the key map by pressing ALT-K again. 

To leave the category manager and return to the view, do one of the 
following: 

• Press ra (TO view). 

• Press Flo (MENU) and select RETURN. 
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Agenda also displays all or part of the category hierarchy when you 
perform these tasks: 

• Select a category for a section head or column head 

• Modify an assignment profile 

• Replace one category in a view with another 

• Attach a condition, action, or filter 

You can add and discard categories and edit category names when 
you display the category hierarchy for these tasks, but you cannot 
modify it in other ways. For information about editing category 
names, see Chapter 5. For information about printing the category 
hierarchy, see Chapter 17. 


Moving Around the Category Hierarchy 


Wherever you display the category hierarchy (in the category man¬ 
ager or elsewhere), you use the same methods to move around, locate 
categories, and collapse and expand families. 

The following table identifies the keys that you can use to move 
around the category hierarchy. 




Move the highlight up one category 
Move the highlight down one category 
Move the highlight up/down one screen 
Move the highlight up/down one sibling 

Go to the parent category of the current category 
Go to the last sibling of the current category 
Go to the first category in the category hierarchy (MAIN) 
Go to the last category in the category hierarchy 




CTRL-PGDN 



Press Fi (HELP) for a comprehensive list of the keys that you can use ir 
the category hierarchy. 
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Locating a You can easily and quickly locate a category wherever you display 

Category the category hierarchy. 

To locate a category: 

1. Start typing the name of the category you want to locate. 

Agenda displays what you type at the top of the screen and high¬ 
lights a category that matches what you have typed so far 
(Figure 16-5). 

You can see any other categories that match what you type by 
pressing T and i or ALT-P and alt-n. 

2. If the category you want is not highlighted, continue to type until 
Agenda highlights it. 

3. When Agenda highlights the correct category, press ENTER. 

If you type a name that does not match an existing category and 
press ENTER, Agenda creates a new category with that name. 



Collapsing and 

Expanding 

Families 


Figure 16-5 Locating a category in the category hierarchy 

You can collapse the category hierarchy to move around faster or to 
see all the categories at a particular level. When you collapse a family 
in the category hierarchy. Agenda does not display the child catego- 

Collapsing families 

You can collapse families anywhere the category hierarchy appears. 
To collapse a family: 

1. Place the highlight anywhere in the family that you want to 
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2. Press alt- - (hold down alt and press minus) to collapse the 
current family or press alt- - twice to collapse all families in the 
category hierarchy. 

Agenda collapses the family (or families). If the highlight was on the 
parent. Agenda displays an ellipsis (...) to indicate that the category 
has children that are not displayed (Figure 16-6). 





ollapsed family symbol- 

PMP 

- - gig 



m 'a 



Figure 16-6 Category hierarchy with collapsed family 


When you collapse a family or the entire hierarchy, it stays collapsed 
until you expand it again. For example, if you collapse the hierarchy 
from the Section Head box, and later press F9 (CAT MGR) to display the 
category manager. Agenda displays the collapsed hierarchy. 

Expanding families 

You can expand one or more collapsed families in the category 
hierarchy. 

To expand a collapsed family: 

1. Highlight the parent category of the family that you want to 

2. Press ALT- = (hold down ALT and press EQUALS) to expand the 
current family or press ALT- = twice to expand all the families in 
the category hierarchy. 

Collapsing families outside the category manager 

When Agenda displays the category hierarchy in the assignment pro¬ 
file, symbols C or Y) appear adjacent to the categories assigned to the 
current item. If you collapse one or more families. Agenda still 
displays any category that has a symbol (* or *c) beside it 
(Figure 16-7). 
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Changing the Structure of a File 


You can change the structure of your file by modifying the category 
hierarchy. You can 

• Add or modify categories 

• Discard categories 

• Rearrange categories 

• Sort categories 

You can add and discard categories wherever Agenda displays the 
category hierarchy. You can rearrange and sort categories only in the 
category manager. 

Adding Categories You might want to add categories to the category hierarchy in order 
to the Hierarchy to structure your file before you begin creating views or to add struc¬ 
ture as your file evolves. 

Note You cannot enter a category at the same level as MAIN. 

Agenda ensures that MAIN is the ancestor of all categories in 
your file. 
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When you add a category to the hierarchy, you can place it where 

you want in the hierarchy in one of two ways. You can 

• Use the Category Add command to specify the parent and other 
properties for the new category. 

• Use the accelerator keys to specify its position relative to another 
category. Agenda gives the new category default properties. 

Adding categories using the Category Add command 

To add a category using the Category Add command: 

1. Press Flo (MENU) and select Category Add. 

Agenda displays the Category Add box. The settings are 
described in "Category Add/Category Properties Settings" later 
in this chapter. 

2. Complete the settings, specifying the parent category in the 
Make child of setting. 

3. Press enter. 

Agenda adds the category after the last child of the specified parent. 

Adding categories using accelerator keys 

To add a category using accelerator keys: 

1. Highlight the category above or below which you want to add a 
new category. 

2. Press any of the keys listed in the following table to add the 
category to your file and place it where you want it. 

3. Type the name of the category that you want to add and press 


Agenda adds the category to the hierarchy. 
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The accelerator keys listed in the following table let you add a new 
category and specify its position relative to another category. 


Modifying 

Category 

Properties 


When you want to Press 


Insert a category below the highlighted category (a 
sibling of the highlighted category). 

Insert a category above the highlighted category (a 
sibling of the highlighted category). 

Insert a category below and to the left of the high¬ 
lighted category (a new family). Remember that you 
cannot enter a category at the same level as MAIN, so 
alt-l does not work if the highlighted category is a 
child of MAIN. 

Insert a category below and to the right of the high¬ 
lighted category (a child of the highlighted category). 
You can use this accelerator key only with standard 
categories. _ 


I' you insert a category in a family and all the other categories in the 
family are sections in a particular view. Agenda makes the new 
category a section in that view. For example, you may have a People 
family with child categories Meg, Tom, and Janet, each of which 
appears as a section head in a view called By Person. If you insert the 
category Sharon in the People family, Agenda automatically displays 
Sharon as a section head in the By Person view. 


You may want to modify a category by changing its name or type, 
making its children mutually exclusive, attaching a condition or 
action, and so forth. You use the Category Properties box to make 
these changes. 

To modify category properties: 

1. Highlight the category you want to modify. 

2. Do one of the following: 

• Press Flo (MENU) and select Category Properties. 

• Press F6 (PROFS). In a view, press F6 (PROPS) twice on a section 
head or column head. 

Agenda displays the Category Properties box. The settings are 
described in the following section. 
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Category Add/ 
Category 
Properties 
Settings 


3. Complete the settings and press enter. 

Agenda modifies the category properties as you specify. 


You use the Category Add settings to specify properties for a new 
category. You use the Category Properties settings to modify an exis¬ 
ting category. 


Category name Specify a category name. (The name combined with 
the short name, if you specify one, and any text conditions cannot 
exceed 69 characters.) 

Make child of/Parent is In the Category Add box, specify a parent 
for the new category in the Make child of setting. In the Category 
Properties box. Agenda displays the parent of the highlighted cate¬ 
gory. You cannot modify the Parent is setting. 

Short name Specify a synonym for the category name. If a column 
is too narrow to display the category name and you have specified a 
shorter short name. Agenda displays the short name instead. (See 
Chapter 5.) You also use the short name for text conditions. (See 
Chapter 19.) 

Also match Specify text conditions. (See Chapter 19.) 

Note Add a note or view the note for the category. (See Chapter 12.) 
Note file Attach a file as the category note. (See Chapter 12.) 
Exclusive children Choose whether items can be assigned to more 
than one child of this category. See "Mutually Exclusive Categories" 
later in this chapter. 

Special action Attach special actions to be taken when items are 
assigned to this category. (See Chapter 21.) 

Statistics Press space bar to see how many items are assigned to 
the category, how many children it has, and how often it appears as a 
section head or in filters, conditions, and actions. 

Advanced settings Press space bar to display the Advanced Set¬ 
tings box. These settings control how Agenda applies text matching, 
conditions, and actions. (See Chapters 19,20, and 21.) These settings 
also control how Agenda applies local protection for a single cate¬ 
gory. (See Appendix G.) 

Type Specify a category type (standard, numeric, date, or unin¬ 
dexed). (See Chapter 3.) 
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Match category name Specify whether you want Agenda to match 
item text to the category name. (See Chapter 19.) 

Match short name Specify whether you want Agenda to match item 
text to the short name. (See Chapter 19.) 

Assignment conditions Attach assignment, date, or numeric condi¬ 
tions. (See Chapter 20.) 

Assignment actions Attach assignment, date, or numeric actions. 
(See Chapter 21.) 


Discarding You can discard categories from your file by discarding them from 

Categories the category hierarchy. When you discard a category. Agenda 

removes it from the file and any view it appears in. 

Caution Discarding a parent category also discards any child cate¬ 
gories it has. 

To discard a category anywhere the category hierarchy is displayed: 

1. Highlight the category you want to discard. 

2. Do one of the following: 

• Press ALT-F4 (DISCARD). 

• Press Fio (MENU) and select Category Discard. 

If the category has children or has items assigned to it. Agenda 
prompts you to confirm that you want to discard it. 

3. Press ENTER to discard the category. 

Agenda discards the category (and any child categories) from the 
category hierarchy and from your file. 

If you discard a category that has items assigned to it, those items are 
no longer assigned to that category. Agenda discards the items only 
if they are not assigned to any other categories. 

Note You cannot recover a discarded category. 
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Rearranging You can rearrange the category hierarchy to group categories within 

Categories in the a family in a logical order or to move a category from one family to 

Hierarchy another. By default, categories are arranged in the order that you 

enter them. 

For example, you might have a column in a view in which you enter 
priorities for items. If you first enter Medium, then Low, and then 
High, then these categories appear in the category hierarchy in that 
order — Medium, Low, and High. 

You can rearrange the child categories within a family so that they 
are listed in a more logical order such as High, Medium, and Low. 
You can rearrange categories only in the category manager. 

To rearrange a category: 

1. In the category manager, highlight the category that you want to 


2. Press alt-fio (move). 

3. Highlight the category below or above which you want to move 
the current category. 

4. Do one of the following: 

• To move the category below the highlighted category, press 

• To move the category above the highlighted category, press 
CTRL-ENTER. 

Agenda places the category where you specify. 


Sorting Categories You can sort child categories in a family in alphabetical order. For 
example, you might have a long list of cities (each of which is a cate¬ 
gory) that appear in no particular order in the category hierarchy. 
You can sort these categories alphabetically so that you can easily 


You can sort categories only in the category manager. 

To sort the child categories in a family: 

1. In the category manager, highlight the parent whose children 


2. Press, 
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3. Press enter to confirm that you want to sort the categories. 
Agenda sorts the child categories alphabetically by the first word in 
the category name. For more information on sorting, see Chapter 15. 
Caution You cannot undo a sort. 


Mutually Exclusive Categories 


You may want to make sure that an item is assigned to no more than 
one child category in a family. To do this, you make the child catego¬ 
ries in the family mutually exclusive. 

For example, if you do not want to assign an item to more than one 
Priority category, you can make the child categories High, Medium, 
and Low mutually exclusive. Figure 16-8 shows a category hierarchy 
in which the High, Medium, and Low categories are mutually exclu¬ 
sive. Agenda marks these categories with a bracket. 



Figure 16-8 Mutually exclusive categories 


Note Items inherited by a category are also subject to mutual exclu¬ 
sion. For example, in the assignment profile in Figure 16-9, 
the item "Is project on schedule?" is directly assigned to Sue; it 
is also assigned to Design through inheritance. Thus, this 
item cannot be assigned to any category in the Marketing or 
Sales families. 








for mutually exclusive categories 

’ones mutually exclusive and an item is 
ne of these categories. Agenda displays the 
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To resolve this conflict, choose one of the following for the Assign 
conflicting itemfs) to setting: 



Categor!es ClUSiVe You can make mutually exclusive categories unexclusive. 

Unexclusive 


To make mutually exclusive children of a category unexclusive: 

1. Highlight the parent category whose children you want to make 
unexclusive. 

2. Do one of the following: 

• In the category manager, press F6 (props). 

• In a view, press F6 (PROPS) twice. 

• Press Flo (MENU) and select Category Properties. 

Agenda displays the Category Properties box. 

3. Highlight Exclusive children and choose No. 

4. Press enter. 

In the category manager. Agenda removes the brackets from the cate¬ 
gories that were mutually exclusive. In a view, there is no indication 
that mutually exclusive categories are no longer exclusive. 



Working with the Category Hierarchy 


Promoting and Demoting Categories 


You can change the relationship of categories to one another by 
changing their level in the category hierarchy. To change a category's 
level, you promote or demote it. 

Promoting a category moves the category up one level in the cate¬ 
gory hierarchy and to the left of its current position. Demoting a 
category moves the category down one level in the category 
hierarchy and to the right of the its current position. 

For example, a category you promote may become the parent of its 
former siblings. A category you demote may become a child of a 
former sibling. 

You might promote and/or demote categories to group categories in 
families. For example, you might enter three names (such as Sam, 
John, and Anna) as section heads in a view. In the category hierar¬ 
chy, these names appear as categories at the same level under MAIN 
(Figure 16-11). 


I 
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Agenda moves the category one level to the left. 

If promoting the category makes conflicting item assignments, 
Agenda tells you about the conflict. See "Resolving Conflicts When 
Promoting Categories" in the following section. 


Resolving 

Conflictswhen 

Promoting 

Categories 


You cannot promote a category if doing so would break one or both 
of the following rules: 


• An item cannot be directly assigned to both a child category and 

• An item cannot be assigned to more than one category within a 
mutually exclusive family. 

If promoting a category breaks either rule. Agenda displays a box 
informing you of the conflict. You can then choose what to do with 
the item(s) that caused the conflict. (If promoting a category breaks 
both rules. Agenda displays the boxes in sequence.) 

The following examples use assignment profiles to illustrate possible 
conflicts and their resolution. 

Assignment to both a child and its parent 

If promoting a category would lead to an item being assigned to both 
a child and its parent. Agenda displays the box shown in 
Figure 16-14. 
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Assignment to mutually exclusive categories 

If promoting a category would lead to an item being assigned to more 
than one mutually exclusive category. Agenda displays the box 
shown in Figure 16-16. 











Working with the Category Hierarchy 


Demoting You demote categories in the category manager. 

Categories 

To demote a category: 

1. In the category manager, highlight the category that you want to 

2. Press F8 (DEM). 

3. Press ENTER to confirm that you want to demote the category. 
Agenda moves the category one level to the right. 

If demoting the category would break the rules of item assignment 
described in "Resolving Conflicts When Promoting Categories" earlier 
in this chapter. Agenda tells you of the conflict. See "Resolving Con¬ 
flicts when Demoting Categories" below. 

Agenda moves the category one level to the right. 

Resol ving If demoting a category would lead to an item being assigned to both a 

Conflicts When child and its parent. Agenda displays the box shown in Figure 16-18. 

Demoting 

Categories 



For example, the assignment profile in Figure 16-19 shows the item 
"Is the project on schedule?" assigned to Sue and Anna. Demoting 
Anna creates a conflict because an item cannot be directly assigned to 
both a child (Anna) and its parent (Sue). 





Chapter 17 
Printing 


Agenda lets you print the contents of a file, as well as information 
about its structure. You can print items, notes, macros, views, the 
category hierarchy, and general information about a file. 

Agenda also lets you determine how your printed page looks. You 
can specify the fonts and text attributes that Agenda uses for printing, 
as well as information about your printed page, including margins, 
spacing, and headers and footers. 

You can save the print settings for a file and retrieve them into 
another. You can also save the print settings for a file and attach 
these settings to one or more views in the current file, or to views in 
other Agenda files. This lets you print a view with print settings 
specific to that view. 

Before you print your file, you can preview it on the screen as a 
formatted document, page-by-page. Previewing a document lets you 
check it for page format, page breaks, and so forth. 


In this Chapter 


This chapter describes how to 

• Set up Agenda to print 

• Define fonts to use for printing 

• Format your page for final printing, including information about 
margins, spacing, fonts, text attributes, and headers and footers 

• Specify the contents and layout of your headers and footers 

• Display your formatted document before you print it 

• Print all or part of your file 

• Print to a file that contains a formatted version of your document 
that you can import into a word processing program 




• Save all the print choices for a file so that you can use them to 
print another Agenda file 

• Attach print settings from a file to one or more views in the cur¬ 
rent file, or to views in other Agenda files, so that you can print a 
view using settings specific to it 

• Save your Print Layout settings as the new defaults for all the new 
Agenda files that you create 


About Printing 


Agenda provides a lot of flexibility when you print your file. You 
can select the fonts and text attributes for printing. You can also 
lay out your printed page to suit your needs. 

Keep in mind the following guidelines when you prepare your file 
for printing. 

• Your printed view, note, or category hierarchy does not neces¬ 
sarily look the same as the view, note, or category hierarchy on 
your screen. 

For example, on the printed page. Agenda wraps item and note 
text, truncates columns, and breaks pages differently from what 


Your page layout, such as 
and so forth, affects how i 


argins, page size, page orientation. 


When previewing and printing a document from a view or note. 
Agenda wraps item and note text, as well as calculation labels. 
Everything else on the page truncates. 


For example, if you choose to print column heads in a view with 
a typeface and/or typeface size that is too big for the width of a 
given column. Agenda truncates the column head on the 
printed page. 


When previewing and printing a file. Agenda uses standard 
American English hyphenation rules when wrapping item ar 



You can perform most print procedures from views, notes, ma 
ros, and the category manager. However, Agenda does not 
maintain separate note and macro print-related information. 
Any changes that you make to print settings in notes are 
reflected in macros. Likewise, any changes that you make to 
print settings in macros are reflected in notes. 


Preparing to Print 


When you install Agenda, the Installation program detects the type of 
display adapter card (and monitor) that your computer has, If your 
computer has a graphics display adapter card, you can preview your 
formatted documents before you print them. (See "Previewing Your 
Work" later in this chapter.) 

Note If your computer does not have a graphics display adapter 

card, or if you choose None/No Graphics for the Select a Print 
Preview Display Driver screen during installation, you cannot 
use the preview feature. 

During installation, you can also select as many printers as you think 
you might use. You also choose one of these printers as your primary 
printer. If you want to use additional printers at another time, you 
must run the installation procedure from your hard disk and select 
Add new printers. For more information, see Chapter 1 in Setting Up 
Agenda. 


Print Setup 


You specify information about your computer and printers during 
installation. You must also use the Print Setup command to provide 
additional information before you print. For example, you use 
Print Setup to specify the printer ports for your primary and second¬ 
ary printers. You can also define the portrait and landscape fonts for 
your primary and secondary printers that you want to use for 
printing. 

The choices that you select using Print Setup apply to all your 
Agenda files. 
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y for preview, highlight Foreground or 
hces), highlight the color you want, and 


he same foreground and background 


l primary printer. Agenda displays the 
2r that you selected during installation. 










The Landscape font list setting displays, depending on the printer 
that you choose in the Primary printer setting. It does not display if 
your printer does not support landscape printing. For information on 
whether your printer supports landscape printing, see Chapter 4 in 
Setting Up Agenda. 

Secondary printer Specify a secondary printer from the list of 
printers that you selected during installation. If you don't specify a 
secondary printer, the default secondary printer is None/No 
Graphics. 

Secondary printer settings are optional. You only need to complete 
them if you plan to use a second printer. The settings and choices for 
the secondary printer are identical to those for your primary printer. 
For this information, refer to the settings described earlier in this 


About Fonts 


A font is a typeface of a particular size. For example, Times Roman 
10 point, Roman 12 pitch, and Courier 10 point are all different fonts. 
Different printers support different fonts. This means that the type of 
printer you use determines the typefaces and typeface sizes that are 
available to you. For your primary and secondary printers. Agenda 
displays the list of fonts for portrait printing in the portrait font list 
and the list of fonts for landscape printing in the landscape font list (if 
your printer supports landscape printing). 

Figure 17-2 shows a font list for the Apple LaserWriter Plus. In this 
example, the user has modified the list to include a variety of type- 







Printing 


Notes You should try to make the fonts in your font lists for your 

primary and secondary printers as similar as possible (partic¬ 
ularly their size) so that you get similar results when you 
print your file, regardless of what printer you use. Since the 

able to make them identical. 

It is also important to define equivalent font lists if you plan 
to share named print set files among Agenda users. For more 
information, see "About Named Print Set Files" later in this 
chapter. 

You can use the names of fonts to serve as reminders of how a partic¬ 
ular font looks. For example, you might change the name of the 
Helvetica 12.0 point font for the Apple LaserWriter Plus (Font 7 in 
Figure 17-2) to "Memo” to remind you that this is the font to use 
when printing memos. 

You can also modify the typeface and/or typeface size for the fonts 
on this list to suit your needs. For procedures, see "Modifying the 
Font list" later in this chapter. 

For example, when you first install Agenda with the Apple 
LaserWriter Plus, most fonts in the font list for this printer default to 
Times Roman 12.0 point. You might decide to define Font 18 as 
Palatino 14.0 point so that you have a larger font when printing page 
headers. You might also decide to define Font 9 as Courier 8.0 point 
so that you have a smaller font when printing views that contain 


The greater the variety of fonts that you specify for the font list, the 
wider the selection of fonts you have to choose from in the Print 
Layout and Header and Footer boxes (and in the Marker box) when 
you print your file. 


Fonts and Print When you display the Print Layout box. Agenda defaults to using 
Layout Font 1 on the font list to print everything in your file (items, notes, 

and so forth). In Figure 17-2, Font 1 on the font list for the Apple 
LaserWriter Plus is Times Roman 12.0 point. Agenda uses this font 
by default for printing everything in the current file with this printer. 

You can print using this font, or you can use the Print Layout com¬ 
mand to select another font from the list defined using the Print 
Setup command. (For example, you can select Times Roman 8.0 
point to print items. Times Roman 12.0 point to print notes, and so 
forth). The fonts that you select using Print Layout become the new 
fonts for printing each part of the current file. So, whenever you 
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print your file. Agenda uses Times Roman 8.0 point to print items. 

Times Roman 12.0 point to print notes, and so forth. (See "Print 

Layout” later in this chapter.) 

Note Some printers do not support more than one font for a line of 
printed text. To determine whether your printer supports 
multiple fonts on a line of printed text, see vour printer 
manual). 

You also use the Print Layout command to select the text attributes 
for printing items, notes, and so forth for the current file. For more 
information, see "Print Layout Settings" later in this chapter. 

You display the font list using the Print Setup command. You dis¬ 
play the font list to see your current list of fonts and to modify the 
fonts on this list. The fonts that you define on the font list make up 
the list of fonts that you can select from in the Print Layout and 
Header and Footer boxes (and in the Marker box) when you print. 

To display the fcmt list: 

1. Press no (MENU) and select Print Setup. 

Agenda displays the Print Setup box. 

2. Highlight Portrait font list under Primary printer and press 


Agenda displays the portrait font list for your primary printer. 

You can also display the landscape font list for your primary printer 
or the portrait or landscape font lists for your secondary printer. To 
display another font list, follow the procedure above. In Step 2, high¬ 
light the font list that you want to display. 

Agenda also displays the name of the printer for the font list you 
display at the bottom of the font list. Agenda displays this printer in 
the Print Layout, Preview, and Final boxes, as well as the Marker box. 
For some printers. Agenda displays information beside the printer 
name about the type of printer, the cartridges selected, and the 
default page orientation. 


• Primary cartridge is A 

• Secondary cartridge is F 

• Page orientation is landscape 





Modifying the 
Font List 


You can change the font name, 
fonts on the font list. 

To change the name of a font 01 

1. Highlight the font name yc 

2. Press P2 (EDIT), make any cl 
Agenda displays the new font r 
To change a typeface on the for 

1. Highlight the typeface that 

2. Press F3 (choices) . 

Agenda displays the typefa 
Figure 17-3 shows the type 
printer. 

3. Highlight the typeface you 
Agenda displays the typeface tl 



Figure 17-3 Sample typefac 
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You can use the choices that Agenda uses by default or you can select 
other choices to customize the printed page. Figure 17-5 shows an 
example of a page printed to the Apple LaserWriter Plus using these 
defaults. If you select other choices for these settings. Agenda saves 
them as the new choices for the current file. 
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Print Layout You use the Print Layout settings to specify information about your 

Settings printed page including the printer, page orientation, margins, spac¬ 

ing, fonts, attributes, paper sizes, separators, and headers and footers. 

Once you press enter to accept the Print Layout box, Agenda saves 
your choices for the current file. 

Note If you select other choices for Printer and/or Orientation, 

these choices are reflected wherever these settings display in 
the current file (in the Print Layout, Preview, and Final boxes, 
as well as in the Marker box for views, notes, and the category 
manager). 

Printer Specify the printer to which you want to print. Press F3 
(CHOICES) to display the list of available choices. These choices are 
the names of the printers you specified as your primary and second¬ 
ary printers (if you selected a secondary printer) using the Print 
Setup command. Highlight the choice you want and press enter. 
Your choice determines which font list Agenda displays in the Print 
Layout, Header and Footer, and Marker boxes. 

For some printers. Agenda displays information beside the printer 
name about the type of printer, the cartridges selected, and the 
default page orientation. 

For example, for the HP LaserJet Series II, Agenda displays 
HP LaserJet II [A,F](L). This means that the: 

• Primary cartridge is A 

• Secondary cartridge is F 

• Page orientation is landscape 

If Agenda displays the printer name with [A] only, this means that 
there is only a primary cartridge. A, and no secondary cartridge is 
selected. If Agenda displays [,F], this means that there is no primary 
cartridge selected and the secondary cartridge is F. If no cartridges 
are selected and the page orientation is portrait. Agenda displays the 
printer name only. 

Orientation Specify the orientation of the pages you want to print. 
Press F3 (choices), highlight the choice you want, and press ENTER. 
The choice you select determines which font list Agenda displays in 
the Print Layout, Header and Footer, and Marker boxes. 

The choices are Portrait and Landscape (if your printer supports 
landscape printing). 




irgin units Specify the units of measurement for margins, custom 
pers sizes, and header and footer spacing and indents. Press 
CHOICES), highlight the choice you want, and press ENTER. 





Header/Footer Specify the contents of your headers and footers, 
and how this information should look on the printed page. Press 
space bar to display the Header and Footer box. See "Specifying 
Headers and Footers" later in this chapter. 

Margins 

The following settings display under Margins. For each setting, 
press GREY + or GREY - to increase or decrease the margin by units of 
one, or simply type the number for the margin and press ENTER. 
These settings are measured according to the Margin units setting. 
Note Some printers have a minimum measurement for page mar¬ 
gins and cannot print to the edge of the page. If the margin 
that you specify is too narrow. Agenda uses a 
printer-dependent minimum margin. See Chapter 4 in Setting 
Up Agenda. 

Top Specify the top margin for your page. 

The default is 1 in. (The range is 0—10 inches, 0—26 centimeters, or 
0—254 millimeters.) 

Bottom Specify the bottom margin for your page. 



egory ana note. 


Spacing (lines) 

The following settings display under Spacing (lines). For each set¬ 
ting, press GREY + or grey - to increase or decrease line spacing by 
units of one, or simply type a number between 1 and 150 and press 


The line spacing settings change, depending on whether you are in a 
view or the category manager. This setting does not apply to notes. 
In a view, specify the line spacing: After items/notes. Between item 
and note. After section head, and After sections. 


In the category manager, specify the line spacing:. 
categories/notes and Between category and note. 





that they become the new Print Layout defaults for all new Agenda 
files you create, see "Saving Print Settings as New File Defaults" later 
in this chapter.) If you don't specify otherwise. Agenda defaults to 
using Font 1 on the font list to print everything in this file. 

Notes To select fonts for a different printer and/or page orientation, 
complete the Printer and Orientation settings using the Print 
Layout, Final, or Preview commands. Agenda displays the 
font list for the printer and page orientation that you specify 
for these settings. 

You can only select from among the fonts that Agenda dis¬ 
plays in the Print Layout box. You cannot change the name, 
typeface, and/or typeface size of any of the fonts displayed 
here. To modify the fonts on the font list, use the Print Setup 
command. 

Some printers do not support more than one font for a line of 
printed text. To determine whether your printer supports 
multiple fonts on a line of printed text, see your printer 
manual. 


The font settings change, depending on whether you are i 
note, or the category manager. 
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Note Agenda always prints file information using the text attribute 
selected for printing categories, as specified in Print Layout. 
(In the category manager, use the Print Final command to 
choose File info for the Print setting.) 

Alignment 

The following settings display under Alignment. For each setting, 
specify where to align information on the printed page. For each set¬ 
ting, press F3 (CHOICES), highlight the choice you want, and press 


Note Numeric column heads and entries are automatically right 
aligned. The Alignment settings have no effect on the place¬ 
ment of numeric columns on the page. 




Specifying Headers and Footers 


Agenda lets you specify the contents and layout of headers and 
footers. When you enter the text for headers and footers, you can 
select the fonts and/or attributes that you want to use to print that 
text. You can also change the fonts and/or attributes for regions of 
text in your headers and footers and insert special markers to pro¬ 
duce other information, such as the current view or file name, when 
you print the file. 

You can specify up to three lines of text each for the header and the 
footer for your file. 

If you do not want to customize the contents and layout of your 
headers and footers. Agenda also provides defaults that you can use. 
These defaults include the special markers for date, time, view name, 
and page number. (For a sample page printed with default headers 
and footers, see "Print Layout" earlier in this chapter.) 

For more information on changing fonts and text attributes for 
regions of text, and inserting special markers, see Chapter 14. 

The settings for header and footer information are identical for views. 

Note Agenda maintains separate header and footer layout informa¬ 
tion (such as spacing, indenting, and lines) for Views, notes, 
and the category manager. However, Agenda does not 
maintain separate header and footer contents, fonts, or attrib¬ 
utes. Any text that you enter for your headers and footers, for 
example, in a view, are reflected in notes, and the category 


You specify the contents and layout of headers and footers in the 
Header and Footer box using the Print Layout command. 

To enter and format headers and footers: 

1. Press Fio (MENU) and select Print Layout. 

Agenda displays the Print Layout box. 

2. Highlight Header/Footer and press SPACE BAR. 

Agenda displays the Header and Footer box (Figure 17-7). The 
settings are described in the following section. 




Header and 

Footer 

Settings 




these settings. 

You can only select from among the fonts that Agenda dis¬ 
plays in the Header and Footer box. You cannot change the 
name, typeface, and/or typeface size of any of the fonts 
displayed here. To modify the fonts on the font list, use the 
Print Setup command. (For information on attributes, see 

Attribute Specify the text attribute for printing headers and footers. 
Press F3 (CHOICES), highlight each attribute you want to use, and press 
SPACE BAR. Agenda displays an X beside your choices. To remove an 
X beside a choice, press SPACE bar again. Then press enter to accept 
your choices. 

Note Agenda lets you specify combinations of attributes, except for 
those that conflict (such as Subscript and Superscript). In 
addition, your printer may not be able to print all attributes 
and/or combinations. 

You can select only one text attribute or combination of attributes for 
both the header and footer. You can, however, change the attribute 
for printing regions of text in headers and footers by inserting attrib¬ 
ute markers. (See Chapter 14.) 






Footer 

The following settings display under Footer. 

Space above Specify the minimum amount of space between the 
last line of text and the first line in the footer on your page. Press 

of one, or simply type the number for the amount of space and press 
enter. This space is measured according to Margin units. (See 
"Print Layout Settings" earlier in this chapter). 

The default is .5 in. (The range is 0—10 inches, 0—26 centimeters, or 
0-—254 millimeters.) 

Indent Specify (in margin units) the amount of space to indent the 
footer from the left and right margins on your page. Press grey + or 
GREY - to increase or decrease the indent by units of one, or simply 
type the number for the indent and press ENTER. Specify 0 in (de¬ 
fault) to align the footer with the margin, a positive number to indent 
into the print area, or a negative number to outdent from the margin. 
This indent is measured according to Margin units. (See "Print Lay¬ 
out Settings" earlier in this chapter). 

The range is -10—10 inches, - 26—26 centimeters, or -254— 254 milli¬ 
meters. 

Line above Specify whether to print a line above your footer. The 
choices are Yes (default) and No. 

Complete up to three lines of text. Each of these lines is divided into 
three parts: Left, Center, and Right. Left prints information left 
aligned. Center prints information centered, and Right prints infor¬ 
mation right aligned within the margins. 

Notes If you enter more text than displays in a setting, (for example. 
Line 1 under Left), the text scrolls. Each setting can contain 
up to 79 characters. Each line of the footer can contain a total 
of 237 characters. 

If you specify more text than can fit on one line, the text 
wraps within its own column. For example, if you specify 60 
characters that are left aligned for Line 1 and 30 characters 
that are centered for Line 1, the left aligned text will wrap 
(since it cannot print across the entire page because of the 

You can also change the fonts and text attributes for regions 
of text, and insert special markers, in your header and footer 
text. (See Chapter 14.) 



Previewing Your Work 


Agenda lets you display, or preview, all or part of your file as a for¬ 
matted document before you print it. Agenda formats your file for 
preview just as it does for final print. This means that when you 
preview a document, you can see all page breaks and other format¬ 
ting information that you specify for printing. You might preview a 
document to see how it will look on the printed page or to proofread 
its contents. 

You can preview all or part of a file in a view, note, macro, or the 
category manager. When you preview a document. Agenda displays 
the Print Preview box. The settings in this box are nearly identical to 
those in the Print Final box. The only difference is that the Print 
Preview box does not include the Print to. Copies, Sort output pages. 
Forms, and Double sided settings since they do not apply to pre¬ 
view. Print Preview settings are described in "Final Print Settings" 
later in this chapter. 

Any changes that you make to settings in the Print Preview box are 
reflected in the Print Final box. Changes to the Print Final box are 
also reflected in the Print Preview box. 

Notes If your computer does not have a graphics display adapter 
card, you cannot use the preview feature. If you selected 
None/No Graphics, or if you selected the wrong preview dis¬ 
play driver during installation, use the Print Setup command 
to select the correct preview display driver. See "Print Setup 
Settings” earlier in this chapter. 

If Agenda displays an out of virtual memory message while 
you are previewing a file, this means that not enough virtual 
memory is allocated for previewing or printing, or that you 
have more virtual memory specified than available disk space 
on your computer. By default. Agenda allocates 1024K (1MB) 
of virtual memory to previewing or printing, which is enough 
to preview or print an Agenda file of approximately 50 pages. 
To change the amount of virtual memory use the 
Utilities Customize command. Every page of text greater 
than 50 pages requires approximately 20K more of virtual 
memory. For better performance, specify as little virtual 
memory as possible. (For more information, see Appendix E.) 



To preview a document: 

1. Press Flo (MENU) and select Print Preview. 

Agenda displays the Print Preview box. 

2. Make any changes to the Print Preview settings; then press 
ENTER to accept the box and preview your file. The settings are 
described in "Final Print Settings" later in this chapter. 

Agenda saves the file and displays your document on the screen. 

Note If your computer has a color monitor, you can specify differ¬ 
ent foreground and background colors for previewing your 
document. See the Print preview display driver setting 
description in "Print Setup Settings" earlier in this chapter. 

When you preview a file, you can also press Flo (MENU) to display the 

Preview commands. These commands are described in the proce¬ 
dures that follow. 


About Preview Agenda offers two types of preview display: 

• Full-page displays a full-page representation of your formatted 
document with status information. 

• Contents displays a third of a page of your formatted document 
with no status information. 

Note Unless you specify otherwise, the first time you preview a file 
Agenda displays the file in full-page preview. If you preview 
a file again. Agenda displays it in either full-page or content 
preview, depending on how you last previewed this file. 
Whenever you change the preview display of a file (for example, 
from full-page to content preview). Agenda displays all your files 
with that type of preview. 










Figure 17-9 Adjusting text size in the magnifier window 

Use the following keys to adjust the portion of text enclosed in the 
selector box and displayed in the magnifier window: 


Key _ 



Increase the portion of text in the selector box 
and decrease the size of the text in the magnifier 

Decrease the portion of text in the selector box 
and increase the size of the text in the magnifier 

Move the selector box right, left, up or down 
Move the selector box to the top left or bottom 

Move the selector box one pixel left, right, up, or 


num lock must be turned off. 


ric keypad and 
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Paging Through a You can page forward or back through a file in either full-page or 

Preview Document content preview display. You can go to a specific page in the docu¬ 
ment, or to the next or previous page. 

To go to a specific page in a preview document: 

1. From the full-page or content preview display, press Flo (menu) 
and select Page. 

Agenda displays the Preview Page menu, which includes the 
Next, Previous, and GoTo commands. 

2. Select GoTo. 

Agenda displays the Go To Page box with the current page num¬ 
ber displayed. 

3. Type the number of the page you want to go to. Then press 


If you specify a number greater than the last page number of the 
preview document. Agenda displays the last page of the docu¬ 
ment. If you specify a number less than the first page of the 
preview document. Agenda displays the first page of the 
document. 

Agenda displays the page of the preview document that you specify. 

To go to the next page in a preview document: 

• From the full-page or content preview display, press Flo (menu), 
select Page, and then select Next. 

To go to the previous page in a preview document: 

• From the full-page or content preview display, press no (menu), 
select Page, and then select Previous. 




Shortcuts to 
Paging Through 
a Preview 
Document 


You can quickly page through a previe 
ator keys in the following table: 


sing the acceler- 


Key 


Moves the screen up approximately one third of the page 

Moves the screen down approximately one third of the 
page in content preview 

Displays the next page of the preview document in full- 
page or content preview. (If you press any of these keys 
on the last page of the document. Agenda exits preview 
and returns to where you were in Agenda before pre- 
viewing your document.) 


Displays the Goto page box in full-page or content pre¬ 
view.^ You use this box tospecify the page to which you 


You can switch the screen foreground and background colors when 
you display a document in preview, depending on your personal 
preference. 


To switch between reverse and normal video: 


1 . From the full-page or content preview display, press Flo (MENU). 
Agenda displays the Preview menu, including either the Normal 
and Reverse commands. The command that displays depends 
upon the current video of the preview display. 

2. Choose either Normal or Reverse and press ENTER. 

Agenda displays your document in the video display that you select. 
The display will be in the colors that you specify in the 
Preview display driver setting using the Print Setup command. (See 
"Print Setup Settings" earlier in this chapter.) 
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Quitting Preview You can quit preview at any time and return to the part of your file 
that you were in. 

To quit preview: 

• From the full-page or content preview display, press Fio (MENU) 
and select Quit, or simply press alt-q. 

Final Printing 


You use the Final Print command to print all or part of your Agenda 
file. When you print your file, you can control the content, form, and 
layout of your printed page. Final print uses the settings, such as 
those for margins, spacing, fonts, text attributes, and headers and 
footers, for views, notes, macros, and the category manager that you 
specify using the Print Layout command. Final print also uses the 
primary or secondary printer that you specify using the Print Setup 
command. 

You can print all or part of your Agenda file from views, notes, mac¬ 
ros, or the category manager. 

To print all or part of your file: 

1. Press HO (MENU) and select Print Final. 

Agenda displays the Print Final box. The settings are described 
in the following section. 

2. Complete the box and press ENTER. 

Note If Agenda displays an out of virtual memory message while 
you are previewing or printing a file, this means that not 
enough virtual memory is allocated for previewing or print¬ 
ing, or that you have more virtual memory specified than 
available disk space on your computer. By default. Agenda 
allocates 1024K (1MB) of virtual memory to previewing and 
printing, which is enough to preview or print an Agenda file 
of approximately 50 pages. 

l o cliange the amount of virtual memory use the 

than 50 pages requires approximately 20K more of virtual 
memory. For better performance, specify as little virtual 
memory as possible. (For more information, see Appendix E.) 






Final Print Settings You use the Final Print settings to select the part of your Agenda file 
you want to print and how you want to print it. 

Note If you select other choices for Printer and/or Orientation, 

these choices are reflected wherever these settings display in 
the current file (in the Print Layout, Preview, and Final boxes, 
as well as in the Marker box for views, notes, and the category 
manager). 

Print Specify the part of your file to print. Your chokes change, 
depending on whether you are in a view, a note, or the category 
manager. Press F3 (CHOICES) to see the list of available choices. High¬ 
light your choice and press enter. 

In a view, the choices are View (default). Marked items in view. 
Section, Current item, and Assignment profile. 

In a note, the choices are AH text in note (default) and Marked text. 

In the category manager, the choices are Category hierarchy (default) 
and File Info. 

Include When you print in a view or the category manager, specify 
whether you want to include notes attached to items or categories. 
Press F3 (CHOICES), highlight your choice, and press ENTER. 

In a view, the choices are Items (default). Items & notes, and 
Notes only. 

In the category manager, the choices are Categories (default). 
Categories & notes. Notes only. 

Print to Specify whether to send output to a printer or to a file. 

Press F3 (CHOICES), highlight your choice, and press ENTER. 

If you select any one of the following choices except Printer, Agenda 
displays the additional setting File. 
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If you do not supply a file name. Agenda uses the name of the current 
Agenda file with an appropriate extension as a default. The file name 
that Agenda creates depends on the type of file to which you're send- 

For this type of file Agenda creates a file named _ 

File with printer FILENAME.PRN 

Text file (without FILENAME.PRT 
printer codes) 

Lotus Manuscript FILENAME.DOC 
PCAfile _FILENAME.DCA 







Forms Specify the paper that you use to print. 

This setting displays if you choose Printer for the Print to setting. 

The choices are Continuous (default). Single sheet (Auto feed), and 
Single sheet (Manual feed). 

If you print to a continuous form. Agenda automatically feeds paper 
to the printer as needed. With single sheet (manual feed). Agenda 
prompts you to insert each sheet of paper into the printer. With 
single sheet (auto feed), the printer prompts you to insert each sheet 
of paper into the printer. For more information on your printer's 
forms-handling capabilities, see Chapter 4 in Setting Up Agenda. 

This setting displays if you choose Printer for the Print to setting. 
Print headers and footers Specify whether to print the headers and 
footers that you specified in the Header and Footer box using the 
Print Layout command. 

This setting displays if you choose Printer or File with printer codes 
for the Print to setting. 

The choices are Yes (default) and No. 


About Named Print Set Files 


Agenda lets you save the choices that you specify for the print set¬ 
tings in an Agenda file so that you can print other Agenda files using 
these choices. This lets you set up a file to print in a particular way, 
and also use these settings to print other files. 

Saving print settings are useful if you want to: 

• Print individual views with print settings that are specific to them 

• Share print settings among your own Agenda files 

• Share print settings with other users 

When you save print settings. Agenda saves all of the print settings 
that you specify using the Print Layout (including headers and foot¬ 
ers), Preview, and Final commands. You save these choices to a 
named print set file. Named print set files are not part of your 
Agenda file; Agenda stores only the file name and path in your 
Agenda file. Each named print set file has the extension .NPS. 











TYPEFACE.PD2 files from the 
tory to yours. Then delete the 
Agenda program directory. 
Caution This procedure overwrite 
previously specified usinj 
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Saving Print 
Settings 


You save your print choices (except those under Print Setup) in a 
named print set file. You can create as many named print set files as 
you like. You can use them to print other Agenda files, or you can 
attach them to one or more views in the current Agenda file, or to 
views in other Agenda files. (See "Attaching Print Settings to a View" 
later in this chapter.) 

You cannot display the contents of named print set files. When you 
save print settings for an Agenda file to a named print set file, give 
the named print set file a name that best describes the settings it 
contains. For example, if you save the print settings for your Agenda 
payroll file, you might name this named print set file PAYROLL.NPS. 
This name reminds you that this file contains the format to print your 
payroll reports. 

To save print settings for the current file: 

1. In a view, note, macro, or category manager, press Flo (menu) 
and select Print Named Save. 

Agenda displays the File box. 

2. Do one of the following: 

• Type the name of a named print set file (up to 8 characters) in 
which you want to save the print settings for the current file 
and press ENTER. 

• Press E3 (choices), highlight a file, and press enter. 

Agenda displays the named print set file with the extension 
.NPS. 

3. Press ENTER. 


If you specify the name of an existing file. Agenda asks if you 
want to replace the existing named print set file. Choose Yes and 
press ENTER to replace the existing named print set file with the 


Agenda s; 
set file. 




Retrieving Print 
Settings 


You can print an Agenda file using the print settings from another 
Agenda file. You do this by retrieving the named print set file that 
contains the print settings that you want to use to print the current 
file. When you retrieve a named print set file into an Agenda file, the 
settings in that named print set file become the print settings for the 
current Agenda file. However, any views with attached named print 
set files print still print using the settings in their respective named 


Note You can only retrieve an existing named print set file. 

To retrieve a named print set file into an Agenda file: 

1. In a view, note, macro, or category manager, press Flo (menu) 
and select Print Named Retrieve. 

2. Do one of the following: 

• Press F3 (choices), highlight a file, and press enter. 

3. Press ENTER. 


Agenda retrieves the named print set file that you specify and over¬ 
writes the print settings in the current Agenda file. These settings 
become the settings for printing the current Agenda file. 


Attaching Print You can save the print choices for a particular Agenda file in a named 

Settings to a View print set file and attach these settings to one or more views. You can 
attach named print set files to one or more views in the current 
Agenda file, or to views in other Agenda files. 

When you attach a named print set file to a particular view, that view 
prints using the settings in that named print set file. Other views in 
the current Agenda file still print using the default print settings for 
the current Agenda file. If any other views in the current Agenda file 
have attached named print set files, these views print using the set¬ 
tings in their attached named print set file. 

You can only attach an existing named print set file to a view. You 
cannot attach a named print set file to a view from notes, macros, or 
the category manager. (To create a named print set file, see "Saving 
Print Settings" earlier in this chapter.) 






Attaching print settings using the View Properties box 

You can also attach and detach named print set files using the View 
Properties box. Named print set displays in the View Properties box 
only if you've selected a primary printer using the Print Setup 

To attach an existing named print set file to a view using the View 
Properties box: 

1. From the view to which you want to attach a named print set file, 
press Flo (MENU) and select View Properties. 

Agenda displays the View Properties box. For the 

Named print set setting. Agenda also displays the named print 

set file that is attached to the current view, if any. 

2. Highlight Named print set and do one of the following: 

• Type the name of an existing named print set file that you 
want to attach to the current view and press enter. 

• Press F3 (choices), highlight the named print set file that you 
want to attach to the current view, and press enter. 

Agenda does not let you specify the name of a new file. 

If a named print set file is already attached to the view. Agenda 
asks if you want to detach this file from the view. Choose Yes 
and press ENTER to detach the current named print set file from 
the view and attach the named print set file that you specified to 
this view. 

3. Press ENTER. 

Agenda attaches the named print set file to the current view. It also 
displays the name of the attached named print set file in the title of 
the Print Layout, Preview, and Final boxes. Until you detach this 
named print setting file from the current view, this view prints using 
the settings in the attached named print set file. 

Displaying the name of the current named print set file 

Whenever there is a named print set file attached to a view. Agenda 
displays the name of the attached named print set file in the title of 
the Print Layout, Preview, and Final boxes. 
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To see what named print set file is attached to a view, you can also 
display the view and do one of the following: 

• Press Flo (MENU) and select View Properties. 

Agenda displays the named print set file attached to the current view, 
if any, in the Named print set setting. 

• Press Flo (MENU) and select Print Named Attach. 

Agenda displays the File box with the name of the attached named 
print set file, if any. 

Detaching Print You can detach a named print set file from a view. This procedure 

Settings from a removes the attachment of the named print set file from the current 

View view but does not erase the named print set file from your disk. 

This means that you can still attach this named print set file to one or 
more views in the current file or to views in other Agenda files. You 
can also still retrieve this named print set file to print an Agenda file 
using the settings in this named print set file. 

You might detach a named print set file from a view if you want to 
print that view using the print settings for the current Agenda file, or 
to attach another named print set file to that view. 

You can detach a named print set file from a view using either the 
Print Named command or the View Properties box. 

Detaching print settings using the Print Named command 

To detach a named print set file from a view using the Print Named 
command: 

1. From the view from which you want to detach the named print 
set file, press Fio (MENU) and select Print Named Detach. 

Agenda asks if you want to detach the current named print set 


Agenda detaches the named print set file from the current view. 
Until you attach another named print setting file to this view, this 
view prints using the print settings for the current Agenda file. 




Detaching print settings using the View Properties box 

To detach a named print set file from a view using the View 
Properties box: 

1. From the view from which you want to detach the named print 
set file, press Fio (MENU) and select View Properties. 

Agenda displays the View Properties box. For the 

Named print set setting. Agenda also displays the named print 
set file that is attached to the current view. 

2. Highlight Named print set and press CTRL-ENTER to clear the file 

Agenda asks if you want to detach the current named print set 
file from the view. Choose Yes and press ENTER. 

3. Press ENTER. 

Agenda detaches the named print setting file from the current view. 
Until you attach another named print setting file to this view, this 
view prints using the print settings for the current Agenda file. 

You can erase a named print set file from your disk if you no longer 
want to attach this file to views or to use this file to print your 
Agenda files. Erasing a named print set file removes the attachment 
of this file to all views in the current Agenda file and erases it from 

To erase a named print set file from your disk: 

1. From a view, note, macro, or category manager, press fio (MENU) 
and select Print Named Erase. 

Agenda displays the File box. 

2. Do one of the following: 

• Type the name of the named print set file that you want to 
erase from the disk. Then press enter twice. 

• Press F3 (CHOICES) and highlight the file that you want to 
erase. Then press ENTER twice. 

Agenda asks if you want to erase the named print set file from 
the disk. Select Yes and press enter to erase this file. 

Agenda removes the attachment of this file to all views in the current 
Agenda file and erases the named print set file that you specify from 



Saving Print Settings as New File Defaults 


Agenda provides defaults for the Print Preview, Final, and Layout 
settings (including for headers and footers). You can use these 
defaults when you print all or part of your Agenda file. You can also 
select choices other than these defaults to customize your final 
printed page. 

If you specify choices for the Print Layout, Preview, or Final settings 
that differ from the defaults that Agenda provides, you can save 
these choices so that they become the new defaults for all new Agenda 
files that you create. (Existing files keep their current settings.) 

Note This procedure also saves any other file properties that you 
change except those for Print Setup. (See Chapter 22.) These 
changes now become the new defaults for all your new 
Agenda files. If you want to save print settings only, you can 
save the choices for the Print Layout, Preview, and Final 
commands to a named print set file. See "About Named Print 
Set Files" earlier in this chapter. 

To save your Print Layout settings as your new file defaults: 

1. Press Flo (MENU) and select File Properties. 

Agenda displays the File Properties box. 

2. Highlight Update defaults and press SPACE BAR. 

Agenda asks if you want to update new file properties. 

3. Select Yes and press enter twice. 

Agenda updates the defaults for this and any new Agenda files that 
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Chapter 18 

Working with Conditions and Actions 


You organize information in Agenda using categories. Agenda often 
assigns certain items you enter to categories automatically. For 
example, if you enter an item in a view that refers to "today," Agenda 
enters today's date in the When column. 

As you develop or modify an Agenda file, however, you may want to 
control when and how Agenda makes assignments of items to cate¬ 
gories. To manage the assignment of items, you use conditions and 

This chapter gives an overview of how conditions and actions work. 
For more information about creating and applying conditions, see 
Chapters 19 and 20. For more information about actions, see Chapter 


How Conditions and Actions Manage Information 


Agenda file. Although the result of these two instructions may some¬ 
times look the same, they actually work quite differently: 

Conditions "pull" items to a category. 

Actions "push" items to other categories. 

Figure 18-1 shows the effect of conditions and actions on the item 
"Have Sydney go over taxes ASAP!". The Taxes category has a condi- 

By default. Agenda automatically assigns any item to a category if the 
item contains the category name. 

After assigning the item to Taxes, Agenda executes an action applied 
to Taxes that assigns the item to the additional categories Accountant 
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Actions Dush. Agenda checks for actions after assigning an item to a 
category. After you (or Agenda) assigns the item to the category, t e 
action tells Agenda to push the item to other categories. For example, 
the category called Taxes has an actionthat assigns teitemsjojhe 

/^tndlTas'S^Srto Taxes is also automatically assigned to 
Accountant and Urgent. 

Conditions and actions save time because they cause Agenda to 
assign categories to items automatically. They also help establish 


Assignments for 
Conditions and 
Actions 


Conditions and actions also differ in the type of assignments they 


• Conditions make conditional assignments 

• Actions make explicit assignments 

Conditions make conditional assignments. Because „ -- 

must be met before Agenda assigns an item to a category, if you later 
change the item, it may no longer meet the condition. In this case. 
Agenda breaks the assignment of the item to that category. The 
assignment of an item to a category by conditions is therefore called 
conditional assignment. For example, if you enter the item Meet 
with John next Thursday”, in Activities Planner, Agenda automati¬ 
cally assigns it to Meetings because it contains the word "Meet . 
However, if you edit this item to read "Telephone John next 
Thursday", Agenda breaks the assignment to Meetings because the 
item no longer contains the word "meet" — the condition is no longer 

Actions make explicit assignments. When Agenda executes an 
action, it assigns the item to one or more additional categories imme¬ 
diately. These new assignments remain intact, even if you break the 
item’s assignment to the category that has the action. For example, if 
you change the item "Have Sydney go over taxes ASAP! to CaU 
Sydney ASAP!", Agenda breaks the assignment to the category Taxes, 
but leaves the item's assignments to Accountant and Urgent. 


I 


These explicit assignments stay until you break diem us, 
example, del or the Item BrkAssign command. Figure I 
the difference between conditional and explicit assignme 
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• Date conditions 

• Number conditions 

A text condition assigns an item to a category only if it contains 
certain words or phrases. For example, you might add a text condi¬ 
tion to the Appointment category that pulls in any item that contains 
the phrase "meet with". 

An assignment condition assigns an item to a category if it is already 
assigned (or not assigned) to another category. For example, you 
have a category called Prospects and you want it to include only 
those items that are already assigned to a person's name and tele¬ 
phone number. You create an assignment condition for Prospects 
that says the item must already be assigned to a Name category and a 
Phone# category before Agenda assigns it to Prospects. 

As another example, suppose you have a category called 
Miscellaneous Project. You want to assign items to that category only 
if they are not already assigned to any other project name. You create 
an assignment condition for Miscellaneous Project that says if the 
item is not already assigned to the category Project, then assign it to 
Miscellaneous Project. This is called a negative assignment condi¬ 
tion and is used by Planner. 

A date condition assigns items to a category if they have a certain 
date. For example, you can attach a date condition to a category 
called This Week that pulls in all items that have When dates that fall 
within the current week. Date conditions can include times as well as 

A numeric condition assigns items to a category that have a certain 
number. For example, you might have a numeric category called 
Amount that contains budget figures. In addition to totaling the bud¬ 
get, you want to flag any items over $1,000 for possible reduction. To 
do this, you attach a numeric condition to a category called Reduction 
that selects only those items that have an amount in the Amount 
category that is more than $1,000. 


When Agenda Each time you enter a new item Agenda automatically checks the 

Checks Conditions item to see if it meets any of the conditions in your file. Agenda also 
rechecks an existing item against the conditions when: 

• You edit the item's text. 

• You assign the item to additional categories. 
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• You break the item's assignment to a category. 

• The system date changes. 

If the item no longer meets a condition. Agenda breaks the assign¬ 
ment of the item to the category with the condition. For example, if 
you have a condition based on today's date. Agenda checks the 
condition again when the system date changes and breaks the assign¬ 
ment for those items that do not refer to the new date. 

Although Agenda checks new or edited items against the conditions 
in a file, it does not automatically check all items. To apply a new 
condition to all the items already in a file, use the Utilities Execute 
command, or the accelerator keys ALT-X and alt-e. For more infor¬ 
mation about applying new conditions to existing items, see 
Chapter 20. 

When to Use As you build an Agenda file, you'll begin to see connections between 

Conditions categories. These connections are the basis for conditions. To help 

identify these connections, you might ask yourself the following 

What is the connection between the categories in the file? Are there 
items assigned to one or more categories that should be assigned to 
other categories as well? For example, if Henry is promoted to direc¬ 
tor of marketing, you might want to create a category called Henry 
and assign items to it only if they are already assigned to the 
Marketing and Issues categories. 

Are there key words or phrases that connect certain items to a cate¬ 
gory? For example, you might want to assign items that contain the 
words "think about" to a category called Ideas. To do this, you create 
a text condition for Ideas that matches on the words "think about". 

Do you use dates to keep track of items? Are there connections 
between certain dates and categories? For example, you might want 
to assign items that have a When date of today to the Today category. 
Can the numbers you enter for items help you organize your items? 
For example, a real estate agent might have a numeric category called 
Price that contains the prices of homes in different neighborhoods. 
The agent can use these prices to group homes by price range. For 
example, the agent can attach a numeric condition to a category 
called Expensive that assigns items to it if the item has a price over 
$150/100. Similarly, the agent can also create numeric conditions for 
the categories Moderate (between $75,000 and $150,000) and Inexpen¬ 
sive (less than $75,000.) 
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About Actions 


an item that is already assigned to a category. There are four kinds of 


• Assignment actions 

• Numeric actions 

• Special actions 

An assignment action triggers additional assignments or removes 
assignments for items, after they are assigned to a category. For 
example, you might attach an assignment action to the Taxes cate¬ 
gory that triggers assignments to the Accountant and Urgent catego¬ 
ries. As another example, you might have an item assigned to the 
category called No Priority. You have three other categories (High, 
Medium, and Low) with assignment actions that remove the item 
from the No Priority category as soon as they are assigned to High, 


A date action assigns items to a date category with a specific date, 
after they are assigned to a category. For example, you might have a 
status report that is due on November 19. You can attach a date 
action to the Status report category that sets a When date of Novem¬ 
ber 19 for an item as soon as it is assigned to Status report. 

A numeric action assigns items to a numeric category with a specific 
number, after they are assigned to a category. For example, if your 
company has job level numbers associated with job titles, you can 
attach a numeric action to each job title category that assigns the 
appropriate number. If the level number for Sales Representative is 
12, you can attach a numeric action to the Sales Representative cate¬ 
gory that assigns the number 12 in the Level category for each person 
assigned to Sales Representative. 

A special action does one of three things to items, after they are 
assigned to a category: 

• Exports them to a structured file 

• Designates them as done 


Discards them 
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For example, if you routinely delegate certain tasks to your assistant, 
Mark, you might attach a special action to the Mark category that 
designates an item as done when it is assigned to Mark. 

When Agenda Each time you assign an item to a category that has an action. Agenda 

Checks Actions automatically applies the action to the item. Unlike conditions, how¬ 
ever, Agenda does not apply the actions again if the item changes. 
Agenda executes an action only once, unless you tell Agenda to apply 
the action again. In addition. Agenda does not apply actions to items 
that were assigned to a category before you attached the action to the 
category. 

To re-execute an action or apply a new action to the items already 
assigned to a category, use the Utilities Execute command. For more 
information about applying actions to items, see Chapter 21. 

When to Use When thinking about using actions, it helps to look at your category 

Actions hierarchy and consider how you use categories to organize the infor¬ 

mation in your file. You might ask yourself the following questions: 
Are there categories that should share items? For example, you 
create an Agenda file to plan a seminar. It includes categories for 
registration, catering, schedules, and so forth. If Dana and Ian handle 
registration, you attach an assignment action to the Registration cate¬ 
gory that also automatically assigns its items to the Dana and Ian 
categories. 

Are there items that should be given the same date? For example, 
every Friday morning you meet with your manager to discuss which 
tasks you should focus on in the coming week. The day before this 
meeting, you want to review all tasks you consider to be high prior¬ 
ity. To make sure you do this, you attach a date action to the High 
priority category that assigns a When date of this Thursday. 

Are there items that should be given the same number? For exam¬ 
ple, you have an Agenda file that includes the price of air fares to 
various cities. You can use a numeric action to attach the appropriate 
air fare to items that are also assigned to a city. So, an item assigned 
to a category called New York gets a price of $150.00, an item 
assigned to the category Houston gets a price of $250.00, and so forth. 
Are there items that should be exported, discarded, or designated as 
done? For example, you might use an Agenda file called NEWS to 
track news items that come into your office. You might also create 
another Agenda file called INTERNAT for international news. 




Chapter 19 

Text Matching and Text Conditions 


Text matching is the ability in Agenda to match an item to a category 
if certain words (for example, the category name) are in the item. 

You can expand text matching for a category by adding text condi¬ 
tions. Text conditions assign items to categories if they contain 
words or phrases other than the category name. Text matching and 
text conditions help organize the items in a file. 

For an overview of conditions, see Chapter 18. For information about 
working with assignment, date, and numeric conditions, see 
Chapter 20. 


In this Chapter 

This chapter describes how to: 

• Add text conditions to a category 

• Edit or clear text conditions 

• Display text conditions in the category manager 

• Control and troubleshoot text matching 
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About Text Matching and Text Conditions 


The most obvious example of text matching is automatic assignment, 
which assigns an item to a category if the item contains the category 
name. For example. Agenda assigns the item "Call Marilyn tomor¬ 
row" to the Marilyn category because it includes the category name, 
Marilyn. 

In addition to automatic assignments, you can set up text conditions 
to match items to a category based on a variety of words or phrases. 
To enter text conditions for a category, you use the Also match set¬ 
ting in the Category Properties box (Figure 19-1). The Also match 
setting lists one or more synonyms, or related words or phrases, that 
you want Agenda to use as text conditions. 

Agenda also uses the Short name setting to match items to a cate¬ 
gory. The category's short name is a single word to use for the cate¬ 
gory if the category's column is too small to display the full name. By 
default. Agenda matches items to a category if they contain the short 


Note The category name, short name, and text conditions together 
cannot exceed 69 characters. 
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of the item to the text condition. For example, to tell Agenda that the 
text of the item must match the text condition exactly, enclose the text 
condition in parentheses. 

The following table summarizes the punctuation marks to use in text 
conditions and what they mean. 


Make an exact match 
Match if the item does not 

Exclude text from text 


Separate multiple text 
conditions and match any 

Separate multiple text 
conditions and match all of 

Match current suffix only 
Match lowercase and 
uppercase text 
Treat the next character as 


(meet with) 


calls;phone 


SurpriseM 


Match any single character Budget?? 
(wildcard) 

Match any number of si* 

characters (wildcard) 


These punctuation marks provide many ways to match items to 
categories. For example, the Meetings category shown in Figure 19-1 
has four text conditions. Because they are separated by semi-colons 
(;), Agenda assigns an item to Meetings if it contains any of these 
phrases. Because the text conditions (meet with) and (talk to) are 
enclosed in parentheses, a matching item must have these words in 
exactly the order shown in the text condition. 

As another example, you might have an Expenses category with the 
following text conditions: 

Cost,!Deduction 
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Agenda assigns an item to the Expenses category if it contains the 
word cost and not the word deduction. 

If you have a category called Stocks with the following text condition: 
-LOTS 

An item that contains the stock name LOTS (all uppercase letters) 
matches the Stocks category. An item that includes the word lots (in 
lowercase), however, does not match. 

The wildcards asterisk (*) and question mark (?) act as substitutes for 
characters within a word or phrase. For example, you might have the 
following text condition: 

Budget?? 

It matches items with the words Budget89, Budget90, Budget91, and 

Similarly, you might enter the following text condition: 
si* 

It matches an item that starts with si, such as slow, slump, or slick. 


Entering Text Conditions 

To enter text conditions for a category: 

1. Highlight a category in a view. 

2. Press Flo (menu) and select Category Properties. 

Agenda displays the Category Properties box (Figure 19-1). 

3. Highlight Also match. 

4. Type Ihe^text condition^) to add, using the appropriate punctua- 

5. When you finish, press enter twice. 

When you enter a new item or edit an existing item. Agenda checks it 
against the text condition(s). If the item matches the text condition(s). 
Agenda assigns the item to the category. 
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Note To have Agenda check the existing items in the file against the 
text condition(s), use the Utilities Execute command or the 
accelerator keys alt-x and alt-e. For the procedure on apply¬ 
ing text conditions to existing items, see Chapter 20. 

Editing and Clearing Text Conditions 

To edit or dear text conditions: 

1. Highlight a category with text conditions. 

2. Press Flo (menu) and select Category Properties. 

Agenda displays the Category Properties box. 

3. Highlight Also match. 

4. Do one of the following: 

• To clear all text condition(s), press ctrl-enter. 

• To edit the text conditionfe), press F2 (EDIT). When you finish, 

5. Press ENTER. 

Agenda changes text matching for that category according to the 
edits you make. 

Displaying Text Conditions in the Category Manager 


To display text conditions in the category manager, if they are not 
showing: 

1. Press F9 (CAT MGR). 

Text conditions display with the punctuation marks you used when 
you added them. Figure 19-2 shows the category manager with sev¬ 
eral categories. The Douglas category has two text conditions. 
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If the category does not have a short name. Agenda separates the 
category name from the first text condition with two semicolons (••) 
as shown in Figure 19-2. 

To hide text conditions in the category manager: 

• Press ALT-F7 (show OA) again. 

Note You can also use the Utilities Customize command to modify 
the category manager so that it always displays text condi¬ 
tions. For more information on the Utilities Customize com¬ 
mand, see Chapter 20. 


Controlling Global Text Matching 

You can control how Agenda matches items to category text through¬ 
out a file using the File Properties command. You can control: 

• What text to match 

• How accurate the match is (match strength) 

• Whether to confirm each match 

• Whether to ignore suffixes or accents 
To control matches throughout a file: 

1. Press Flo (MENU), and select File Properties. 

Agenda displays the File Properties box. 

2. Highlight Auto-assign settings and press space bar. 

Agenda displays the Auto-assign Global Settings box 
(Figure 19-3). The settings that control text matching are 
described in the following section. 









Note If you change Match on for an individual category (see 

"Controlling Text Matching for a Category" later in this chap¬ 
ter), Agenda displays the new choice in the category manager 
preceded by the indicator T- For example, if you change 
Match on for the category Expenses to Note text. Agenda 
displays the following notation in the category manager: 
Expenses T= Note 

This tells you that Agenda matches items to the Expenses 
category based on the category's Match on setting, not the 
global setting. (If you don't see this notation in the category 
manager, press ALT-F7 (SHOW C/A) to display text conditions.) 


Required match strength Specify the percentage of words in a 
category name, short name, or text condition that must be in the text 
of an item for a match. 


Exact match - 100% (d 


Partial match-50% 




Item matches category if all the words in the 

Item matches categoiy if at least half of the 
words in the category name, short name, or 
text condition are in the item 
hem matches category if at least one word in 
condition are in the item 


Examples 

You have a category called Suggestions for design. The following 
item contains all three of the words in the category name: 

"Remember to ask Mary for her latest design suggestions" 


This item has a match strength of 100 percent (3 for 3) and Agenda 
assigns it to the category under any of the choices for Required 
match strength. 


The following item has two of the three words: 


"Get suggestions for increasing sales in the Northeast” 

It has a match strength of 67 percent (2 for 3). It matches the category 
if Required match strength is set to Partial match or Minimal match. 







Ignore accents Specify whether Agenda should ignore aco 
when matching words. This is useful if a file includes words 
language other than English. 

The choices are No (default) and Yes. 

If you choose Yes, Agenda does not check for accents when m 
words. For example, resume matches resume. 
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Confirming 

Suggested 

Assignments 


If you change Confirm Assignments to Always or Sometimes and 
then enter a new item that could be assigned to a category. Agenda 
displays a question mark (?) indicator in the upper right corner of the 
screen. The question mark (?) tells you that Agenda has a suggested 
assigment for the item. 

To confirm suggested assignments and remove the question mark (?) 
indicator from the screen: 

X. Press Flo (MENU) and select Utilities Questions. 

Agenda displays the first item that needs confirmation along 
with the suggested assignments) (Figure 19-4). 

2. Do one of the following: 

• Highlight a category and press SPACE BAR to assign the item 
to that category. 

• Press tab to assign the item to all of the suggested categories. 

• If you don't want to confirm any of the suggested assign¬ 
ments, go to Step 3. 

Agenda displays an asterisk (») beside the categories you select. 

3. Press enter. 

If there is another item that needs assignments confirmed. 
Agenda displays that item and its suggested assignments. 

4. Repeat Steps 2 and 3 for each item that has suggested assign- 


Agenda makes all the assignments you confirm. Any other assign¬ 
ments are unaffected. 

Note The assignments you make using the Utilities Questions 
command are explicit assignments that do not change if the 
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Controlling Text Matching for a Category 

You can further control text matching for a particular category using 
the Category Properties command. You can: 

• Turn off matching for the category name and short name 

• Control how Agenda matches text for the category 

Turning off Text To turn off matching for a category name and/or short name: 

Matching 

1. Highlight a category. 

2. Press Flo (menu) and select Category Properties. 

Agenda displays the Category Properties box. 

3. Do one or both of the following: 

• Highlight Match category name and choose No. 

• Highlight Match short name and choose No. 

4. Press enter. 

From now on. Agenda does not match on the category name and/or 
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The following table shows some examples of how Agenda interprets 
words and punctuation marks. 


Things to do 3 words 

People:plaees:things 3 words 


High-capacity drive 2 words 
First_quarter_1 word 


Interpreting If text begins with a number or currency symbol (dollar sign ($), 

Numbers pound sign (£), or yen sign (¥)) Agenda interprets it as a number. It 

interprets punctuation marks included in the text, such as colon (:), 
and period (.), as part of the number. 


Interpreting Dates If text begins with a number and includes a valid date separator. 

Agenda interprets it as a date. The valid date separators are: 
Colon (:) 

Comma (,) 

Hyphen (-) 

Period (.) 

Slash(/) 

For example: 

5/10/90 

6-3-91 

12.7.90 

To see the current date separator: 

• Press Flo (MENU), select File Properties, Global date settings. 
Input Format. 



Interpreting Names If a category name includes two or more consecutive words with ini¬ 
tial capital letters. Agenda treats those words as a proper name. 
When matching against a proper name. Agenda checks for both first 
and last names. For instance, an item that includes the text "Michael 
Schaeffer" matches the category Michael or the category Schaeffer or 
the category Michael Schaeffer, but not the category Michael Rowles. 

Agenda ignores titles in matching names. For example, an item that 
includes the text "Mrs. Wohl" matches the category Wohl or the cate¬ 
gory Nancy Wohl. Therefore, do not include a person's title in a 
category name. 

Agenda recognizes the following words as titles: 

Dr. Mme Herr Frl. 

M. Mmes Hr. Fru 

Monsieur Mademoiselle Frau Froken 

MM. Mile Fr. Frk. 

Madame Miles Fraulein 


Agenda recognizes these words as titles whether they end with a 

Note If a category name contains two words or more and is not a 
proper name, do not use initial capital letters for each word in 
the name. For example, use Status report, not Status Report. 


Ms. 

Miss 

Mrs. 


Troubleshooting Text Matching 


If text matching is not working the way you think it should, check the 

following: 

• To see how items match particular text, use the 
Utilities Show Match command. (See Chapter 15.) 

• Make sure Text matching in both the Auto-assign Global 
Settings box and the Advanced Settings box is set to On. 

• Make sure Apply conditions in both the Auto-assign Global 
Settings box and the Advanced Settings box is not set to Never. 

• Check Match on in the Auto-assign Global Settings box to make 
sure Agenda is searching in the right place for text to match. For 
example, if Match on is set to Note text. Agenda does not check 



n the Auto-assign Global 

--- j -ecrease the required match 

shength so that more items can be assigned based on partial 

Check for a question mark (?) in the upper right comer of the 
screen. If there is one. Agenda is suggesting matches for you to 
confirm using the Utilities Questions command. 

(See "Confirming Suggested Assignments" earlier in this chapter.) 
Check to see if text conditions for a given category are separated 
by commas (,). If so. Agenda pulls in items only if they match all 
the text condition(s). 



Chapter 20 

Assignment, Date, and Numeric Conditions 


Assignment, date, and numeric conditions assign an item to a cate¬ 
gory based on the item's existing assignments to other categories in 
the file. For example, an assignment condition for the Urgent 
category can assign items to Urgent if they are already assigned to the 
category Taxes. Similarly, a date condition for Urgent can assign an 
item if it has a due date of this week, or a numeric condition can 
assign an item to Urgent if the item's assignment to the category Cost 
is greater than $1,000. 

For an overview of conditions, see Chapter 18. For information about 
working with text conditions, see Chapter 19. 

Note In this chapter, "condition" refers to assignment, date, and 
numeric conditions as a group. Unless noted, ''condition" 
does not refer to text conditions. 


In this Chapter 


This chapter describes how to: 

• Attach conditions to a category 

• Edit, clear, and copy conditions 

• Apply conditions to existing items 

• Display conditions in the category manager 

• Control conditions 




About Conditions 


An assignment condition assigns an item to a category, based on its 
current assignment (or lack of assignment) to other categories. A 
date condition assigns an item to a category based on its assignment 
to a date category, such as When, Entry, or Done. A numeric 
condition assigns an item to a category based on its assignment to a 
numeric category. Each of these conditions build connections 
between categories, as the following examples show. 

Example 

Steve handles all delinquent accounts. You attach two assignment 
conditions to the Steve category that assign items only if they are 
already assigned to the Account and Delinquent categories. 

You have a date category called Deadline to track all the deadlines for 
a project. To make sure you stay on top of the milestone dates, you 
create an Urgent category with a date condition that assigns an item if 
it has a deadline date within the next week. 

You are planning a conference and have to make room assignments 
for various presentations. You use a numeric column called Head- 
count to keep track of the number of people registered for each pre¬ 
sentation. Any presentation that draws more than 200 people needs 
to be scheduled in the auditorium. You attach a numeric condition to 
the Auditorium category that assigns items with headcounts over 


Attaching Conditions 


You attach conditions to a category using the Category Properties box 
(Figure 20-1). You use the Assignment conditions setting to attach 
one or more conditions to a single category. 
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Note You can also assign a mix of text conditions and assignment 
conditions to a category. In this case. Agenda assigns an item 
to the category if it meets either the text condition or the 
assignment condition, unless you specify otherwise. For 
more information, see "Controlling Conditions for a Cate¬ 
gory." 


Attaching Date 
Conditions 


To attach a date condition to a category: 

1. Highlight the category. 

2. Press Flo (MENU) and select Category Properties. 

Agenda displays the Category Properties box (Figure 20-1). 

3. Highlight Assignment conditions. 

4. Type the name of a new or existing date category to list in the 
condition and press ENTER. 

Agenda displays the Date Condition box (Figure 20-3). 

5. Do one of the following: 

• Press ENTER to assign items with any date in the date cate¬ 
gory. Then skip to step 7. 

• Highlight Start Date, type the first date in the range for the 
condition, and press ENTER. Then highlight End Date, type 
the last date, and press ENTER. To indude a single date for the 
condition, enter the same date in Start Date and End Date. 

Agenda displays the Items should be setting. 

6. Select Inside range or Outside range to specify whether the 
items should be inside or outside the date range you entered in 
Step 5. Then press enter. 

Agenda displays the date category and date range selected for the 
condition in Assignment Condition. 


When you create a date condition, you specify a date category (such 
as When) and a date, or range of dates, that the item must match to be 
assigned to a category. For example, you could have a category 
called Completed tasks that assigns all items if they are already 
assigned a Done date of today or any date in the current week. 




The Date Condition box 


Figure 20-3 


Attaching Numeric 
Conditions 


When you create a numeric 
gory (such as Amount) and 
item must have to be assign 
have a category called Expe 
amount of $1,000 or more in 


condition, you specify a numeric cate- 
a number, or range of numbers, that the 
ed to a category. For example, you could 
nsive that assigns all items that have an 
L the numeric category Amount. 


To attach a numeric condition to a category: 


Highlight the category to have an numeric condition. 


Agenda displays the Category Properties box (Figure 20-1). 
Highlight Assignment conditions. 


Agenda displays the Numeric Condition box (Figure 20-4). 

5. Do one of the following: 

Press enter to assign items with any number in the numeric 
category. Then skip to step 7. 

• Highlight Minimum Value, type the lowest number in the 

range for the condition, and press enter. Then highlight 
Maximum Value, type the highest number, and press ENTEJ 
To include a single number for the condition, enter the same 
number in Minimum Value and Maximum Value. 





Editing and Clearing Conditions 

You can edit or clear a condition using the Category Properties com¬ 
mand. You can change: 

• Whether the condition assigns items to the category 

• The date or date range in a date condition 

• The number or range of numbers in a numeric condition 

• Whether a date or numeric condition assigns items inside or out¬ 
side a specified range 

• Remove an assignment, date, or numeric condition for a category 
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To edit or dear a condition: 

1. Highlight the category that has the condition you want to edit. 

2. Press Flo (MENU) and select Category Properties. 

Agenda displays the Category Properties box (Figure 20-1). 

3. Highlight Assignment conditions. 

4. Highlight the condition you want to edit or dear. 

5. Do one of the following: 

• Press DEL to dear the condition. Repeat Steps 4 and 5 for 
every condition you want to dear. Then skip to Step 7. 

• Press F4 (VALUES) to edit the condition. 

Agenda displays the appropriate box for the type of condition 
you select. (For example, for a date condition. Agenda displays 
the Date Condition box.) 

6. Highlight the settings you want to change and type the changes. 
When you finish, press enter. 

Agenda displays the edited condition(s) in the Assignment 
conditions setting. 

7. Press ENTER. 

Agenda edits or dears the condition(s) for the category as you spec- 


Controlling Global Conditions 


You can control how Agenda applies conditions throughout a file 
using the File Properties command. You can control: 

• Whether assignment, date, and numeric conditions are turned on 

• When Agenda applies conditions to the items in your file 

• How Agenda handles a conditional assignment that conflicts with 
an existing assignment 

• How Agenda combines assignment, date, and numeric conditions 
with text conditions 
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Override the old (default) Agenda removes tl 
condition. 

Keep the old Agenda ignores th< 


Relationship of text and assignment conditions Specify how you 
want Agenda to combine conditions for categories that have at least 
one text condition and one or more of the other three types of condi¬ 
tions (assignment, date, numeric). The choices are OR (!) (default), 
and AND (&). 


Choice _ Result 


OR (!) (default) Agenda assigns an item to the category if it meets either 
the text condition or the other types of conditions. 

AND (&) Agenda assigns an item to the category only if the item 

meets both the text condition and the other types of 
conditions. 


For example, you might have a category called Calls with a text 
condition that assigns items that include the word "phone" and an 
assignment condition that assigns items that are assigned to Urgent. 
If you choose OR (!), Calls assigns items that have the words "call' 1 c 
"phone” or are assigned to Urgent. If you choose AND (&), Calls 
assigns only items that include the word "call" or "phone" and are 
assigned to Urgent. 


Controlling Conditions for a Category 

You can control the way Agenda applies conditions to individual 
categories using Advanced settings in the Category Properties box. 
To control how Agenda applies conditions to a category: 

1. Highlight the category. 

2. Press fio (menu) and select Category Properties. 








ment conditions, you are setting the category to the same choice you 
made for Relationship of text and assignment conditions in the 
Auto-assign Global Settings box. For information about these set¬ 
tings, see "Auto-assign Global Settings" earlier in this chapter. 

Allow explicit assignments Specify whether Agenda should allow 
explicit assignments to this category. The choices are Yes (default) 
and No. 

If you choose Yes, you can make only explicit assignments to this 
category, for example, by entering the item in the category's column, 
or by creating an action. 

If you choose No, Agenda makes only conditional assignments to the 
category. If you attempt to make an explicit assignment to this cate¬ 
gory, Agenda changes it to a conditional assignment, since you speci¬ 
fied that the category cannot have explicit assignments. 

When you choose No, Agenda displays the additional setting Make 
items fit the category settings. 

Make items fit the category settings Specify whether to make (or 
break) other assignments for items in this category. Agenda needs to 
make additional assignments for an item only if you enter an explicit 
assignment for the category and Agenda changes it to a conditional 
assignment. In this case, you use this setting to tell Agenda to try to 
make the conditional assignment true by assigning other categories to 
the item. The choices are Yes (default) and No. 

If you choose Yes, any items assigned to this category are also 
assigned to the categories listed in the condition that Agenda created. 
For example, suppose you have a category called Urgent with the 
following condition: 

C= Bob 

By default. Agenda assigns items to Urgent if they are already 
assigned to Bob. However, if you choose Yes for Make items fit the 
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eric Conditions 


If you choose No for Make items fit the category setting. Agenda 
does not make any additional assignments for the item and the condi¬ 
tion created by Agenda for the category may or may not be true. 


Conditions and the Category Manager 


You can attach, edit, clear, and copy conditions using the category 
manager. This is a convenient method for working with several con¬ 
ditions at the same time. 


Attaching and To attach or clear a condition to a category: 

Clearing 6 3 

Conditions 


1. Highlight the category. 

2. Press F9 (CAT MGR). 

Agenda displays the category manager. 

3. Press F6 (PROPS). 

Agenda displays the Category Properties box (Figure 20-1). 

4. Highlight Assignment Conditions and press F3 (CHOICES). 
Agenda displays the Assignment Conditions box (Figure 20-7). 

5. Highlight the first category you want to include in the condition 
and press space bar or F7 (inclcat) to attach a condition to that 
category. 


Press SPACE BAR or F7 (INCLCAT} Result 


signs items if they are 
ategory included in the 
da displays a plus sign 
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Shortcut for 
Displaying the 
Assignment 
Conditions Box 


To display the Assignment Conditions box for a category in the cate¬ 
gory manager: 


• Highlight a category and press ALT-P. 


By default. Agenda does not display conditions (or actions) in the 
category manager. However, you can display conditions (or actions) 
using the Utilities Customize command. You can also turn on and 
off the display of conditions (or actions) for the current file using 
ALT-F7 (SHOW c/A). For more information about actions, see 
Chapter 21. 

To display conditions in the category manager for all files: 

1. In a view, press Flo (MENU) and select Utilities Customize. 
Agenda displays the Utilities Customize box. 

2. Highlight Display cond/act info and select Yes. Then press 


Agenda displays the condition(s) for each category beside the cate¬ 
gory name. 

To display conditions in the category manager for the current file: 

• Press ALT-F7 (SHOW C/A). 

Agenda displays the condition(s) for each category next to the cate¬ 
gory name. The assignment, date, and numeric conditions begin with 
the letter C followed by an equal sign (=). 

If a category has more than one condition attached. Agenda separates 
the conditions with a comma. For example. Figure 20-8 shows the 
category Dana with two conditions (-Conference, Survey). These 
conditions assign items to the Dana category that are not assigned to 
Conference and are assigned to Survey. 



Figure 20-8 Conditio 
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Press ALT-F7 (show c/A) again to hide the display of conditions and 


If all the conditions attached to a category can't display on the screen, 
Agenda displays two dots (..). You can display all the conditions 
attached to a category using the Category Properties command. 

The display of conditions in the category manager can also include 
letters and symbols for settings you use to control conditions. The 
following table describes the symbols for these settings. The settings 
are described in "Controlling Conditions for a Category" earlier in 
this chapter. 


Symbol Means 

± If an assignment conflicts with another is set to Keep the old. 

! Relationship of text and assignment conditions is set to OR 

& Relationship of text and assignment conditions is set to AND 

O Apply conditions is set to On demand 

o Apply conditions is set to On demand for parent category 

N Apply conditions is set to Never 

n Apply conditions is set to Never for parent category 


CiearingAII To clear all conditions for a category in the category manager: 

Conditions 

1. Highlight the category. 

2. Press alt-fs <clr c/A). 

If the category has both conditions and actions. Agenda asks you 
whether to clear conditions, actions, or both. If the category has 
only conditions. Agenda asks you if you want to clear them. 

3. Do one of the following: 

• If the category has both conditions and actions, press 
F3 (choices), highlight your choice, and press enter. 

• If the category has only conditions, press enter to confirm 
that you want to clear the conditions. 

Agenda clears all the conditions from that category. 






20-18 Assignment, Date, ( 


For the procedure to clear one condition assigned to a category, see 
"Clearing Conditions" earlier in this chapter. 





in copy a set of conditions from one category to another. Copy- 
rdi lions is a quick way to attach the same conditions to more 
ne category. If the category has actions as well as conditions, 
n also choose to copy the actions when you copy the condi- 


Caution 


If you copy conditions to a category that already has con¬ 
ditions, the copied conditions replace the original condi- 


To copy conditions from one category to another: 

1. Highlight the category with the conditions you want to copy. 

2. Press ALT-F9 (CPY C/A). 

3. Highlight the category to copy to and press enter. 

If the category you are copying from has conditions only. 
Agenda copies them to the other category selected. Skip the rest 
of this procedure. 

If the category you are copying from has both conditions and 
actions. Agenda asks you whether to copy the conditions, 
actions, or both. 

4. Press ra (choices) to display the choices. 

5. Highlight your choice and press ENTER. 

Agenda copies the conditions to the category you specify. 


Applying New Conditions to Existing Items 


When you enter an item. Agenda automatically checks it against all 
the conditions in a file. If the item meets a condition. Agenda assigns 
it to the category with that condition. (See Chapter 18.) 

Agenda does not, however, automatically check the items already in a 
file against a new condition. To apply a condition to existing items, 
use the Utilities Execute command. 



Using the Utility 
Execute Command 


Execute Settings 
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To apply the conditionfe) attached to a category: 

1. Type the category name or press ra (CHOICES) to display the cate¬ 
gory hierarchy 

2. Highlight the category and press enter. 

Against Specify the items to which you want to apply conditions. 
The choices are All items (default). Current item. Marked items. 
Items in section, and Items in view. 

Apply actions to Specify whether you want Agenda to apply new 
actions to existing items. The choices are New assignments only 
(No) (default) Old & new assignments (Yes). 

Shortcuts to To apply all conditions in a file to all items in a file- 

Applying 

Conditions 

• Press ALT-x 

Agenda applies all conditions in the file to all items in the file. (If the 
file is large. Agenda may take some time to complete this process.) 

To apply all the conditions in the file to one particular item: 

1. In a view, highlight the item to which you want to apply condi¬ 
tions. 

2. Press alt-b. 

Agenda applies all the conditions in the file to the current item. 

To apply the conditionfe) attached to a particular category and its 
children to all the items in a file: 

1. In a view, highlight the category with the conditionfe) you want 
to apply. 

2. Press alt-e. 

Agenda applies the conditionfe) attached to the category and its chil¬ 
dren to all the items in the file. 
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Correcting Contradictory Conditions 


You can inadvertently create a condition that contradicts itself. For 
example, as soon as an item meets the condition, it causes the condi¬ 
tion to be false. The item then gets caught in a loop where it is contin¬ 
uously assigned to and removed from the category. This loop is 
called a circular reference. 

Here is an example of a condition that causes a circular reference: 

Ed C=-People 

This condition assigns items to the category Ed that are not assigned 
to the category People. However, as soon as an item fulfills this 
condition and is assigned to Ed, it is assigned to People through 
inheritance. This means it no longer meets the condition, so Agenda 
breaks the assignment to Ed. 

When Agenda breaks the assignment to Ed, however, it also breaks 
the assignment to People, which means that the item is once again not 
assigned to People and meets the condition attached to Ed. Agenda 
assigns it to Ed again. After this happens a few times. Agenda identi¬ 
fies the situation as a circular reference and displays an open circle (o) 
indicator in the upper right corner of the screen. 

To correct this contradictory condition, you add an action to the Ed 
category as follows: 

Ed C= -People, A= Ed 

The action makes an explicit assignment to the Ed category and is not 
inherited by the People category. For more information about 
actions, see Chapter 21. 

To see what is causing the circular reference, you can display all the 
items involved in any circular references. 

To display items in circular references: 

• In a view, press Flo (Menu) and select Utilities Show Circular. 
Agenda creates a view called 'Show View* with a category called 
Circular Reference! that includes all of the items involved in a circu¬ 
lar reference. 




Chapter 21 
Actions 


Actions act on items after they axe assigned to a category. For exam¬ 
ple, you might attach an action to the Marketing category that trig¬ 
gers an assignment to the Sales category. In other words, every time 
you assign an item to Marketing, Agenda also automatically assigns 
it to Sales. 

For an overview of actions, see Chapter 18. For information about 
working with conditions, see Chapters 19 and 20. 


In this Chapter 


This chapter describes how to: 

• Attach actions to a category 

• Edit, clear, and copy actions 

• Apply new actions to existing items 

• Display actions in the category manager 

• Turn off actions 


About Actions 


• Assignment actions trigger additional assignments for the items 
assigned to a category. 

21-1 


i assigned to a category. 




Actions 


Numeric actions assign numbers to the items assigned to a cate¬ 
gory. 


• Special actions do one of three things to the items assigned to a 
category: discard them, export them, or designate them as done. 
You can also use actions to break assignments. For example, you 
might attach an assignment action to the Paid category that breaks an 
item's assignment to the Receivables category. As soon as an item is 
assigned to Paid, Agenda breaks its assignment to Receivables. 
Actions automate the assignment of items to categories, dates, or 
numbers. Special actions are a quick way to perform an operation on 
a group of items in a category. The following examples illustrate 

how you might use each of these types of actions. 

Example 

You and three colleagues work on a project with the code name 
Eaton. To make sure all of you receive the same information about 
the project, you assign an action to the Eaton category in which any 
item assigned to Eaton is also assigned to the category for each col- 
leaeue. ’ 


Example 

You are a person who makes frequent business trips to other cities. 

To help you complete the expense report for a trip, you assign an 
action to each City category that automatically assigns the appropri¬ 
ate round trip air fare to an item each time you assign that item to a 
aty. 

Example 

You are using Agenda to prepare two reports, one on Auguste Renoir 
and another on Claude Monet. You create a separate Agenda file for 
each artist. Since these two men were contemporaries, some of the 

material in the Renoir file discusses Monet and vice versa So you 

create a category for one man in the other man's file. That is, the 
Renoir file has a Monet category and vice versa. 

You attach a special action to the Monet category in the Renoir file 
that exports items to the file MONET.STF when they are assigned to 
Monet You also attach a special action to the Renoir category in the 
Monet file that exports items to the file RENOIR.STF when they are 
assigned to Renoir. You can then use the Auto-import file setting 



under the File Properties command to import the text to the corre¬ 
sponding Agenda (.AG) file. (For more information about importing 
and exporting files, see Chapter 23.) 


Attaching Actions 


You attach actions to a category using the Category Properties com¬ 
mand. You use the Assignment actions setting to attach one or more 
actions to a single category (Figure 21-1). 



Figure 21-1 The Category Properties box 


If you attach more than one action to a category. Agenda assigns 
items to the category with the action, and also to the other categories 
listed in the actions. For example, you can attach an action to the 
Deduction category that assigns its items to the additional categories 
Taxes and Accountant. 


Attaching To attach an assignment action to one category: 

Assignment 

Actions 

1. Highlight the category. 

2. Press Flo (menu) and select Category Properties. 

Agenda displays the Category Properties box (Figure 21-1). 

3. Highlight Assignment actions. 





u - repeal jeeps * ana o tor any other assignment actions you w 
to attach to the category. When you finish, press ENTER. 

From now on, whenever an item is assigned to the category that ] 
the assignment action. Agenda makes (or breaks) an assignment 
the category included in the action. 



Figure 21-2 The Assignment Action box 
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Agenda displays the numeric category and number in the 
Assignment actions setting. If the numeric action removes num¬ 
bers from items. Agenda displays a minus sign (-) beside the 
category name. 


From now on, every time an item is assigned to the category that has 
the numeric action. Agenda assigns or removes a number. 



Figure 21-4 




Editing and Clearing Actions 


You edit or clear actions using the Category Properties command. 

• Set an action to make or break assignments 

• Change a date or number in a date or numeric action 

• Remove an action for a category 

To edit or clear an action for a category: 

1. Highlight the category. 

2. Press Flo (MENU) and select Category Properties. 

Agenda displays the Category Properties box (Figure 21-1). 

3. Highlight Assignment actions. 

4. Highlight the action to edit or clear. 
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5. Do one of the following: 

• Press del to clear the action. Repeat Step 4 and this Step for 
every action you want to dear. Then skip to Step 7. 

• Press F4 (VALUES) to edit the condition. 


Agenda displays the appropriate box for the type of action. For 
example, for a date action. Agenda displays the Date Action box. 


Highlight and edit the settings you want to change. Then press 


Agenda displays the edited action in the Assignment actions set¬ 
ting. 


Agenda uses the edited actions when assigning items to categories. 

Attaching and Clearing Special Actions 

You use spedal actions to: 

• Designate items as done when they are assigned to a category 

• Export items to a structured file when they are assigned to a cate¬ 
gory 

• Discard items when they are assigned to a category 

Note You cannot attach more that one special action to a category. 
To attach or dear a spedal action to a category: 

1. Highlight the category. 

2. Press Flo (MENU) and sdect Category Properties. 

Agenda displays the Category Properties box (Figure 21-1). 

3. Highlight Special actions and press F3 (choices). 

Agenda displays the choices. 
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Designate item as do 


Agenda clears the special action from the category. 
Agenda discards items when they are assigned to 
the category. 

assigned to tte category. 6 ^ 


Export item 


Export to file 


they are assigned to the category. If you choose 
Export, Agenda displays two additional settings. 
Discard items and Export to file. 

Choices are No (default) and Yes. Choose Yes to 
discard items after exporting them. 


Specify the nan, 
the exported ite 


of the structured file to contain 
is. The default is EXPORT.STF. 


4. Choose the special action to attach to the category. If you choose 
to export items, complete the additional settings Discard items 
and Export to file. When you finish, press enter. 

From now on, whenever an item is assigned to the category that has 
the special action. Agenda performs the special action. 


Turning Off Actions Globally 


You use the File Properties command to turn off actions throughout 
a file. You might do this when you import information from a large 
structured file, since it takes time for Agenda to check each imported 
item against all the actions. 

Note You can't turn off special actions. 

To turn off actions throughout a file: 

1. In a view, press Fio (MENU) and select File Properties. 

Agenda displays the File Properties box. 

2. Highlight Auto-assign settings and press space bar. 

Agenda displays the Auto-assign Global Settings box (Figure 



erties. (See the preceding section.) Use this setting for a category to 
override the global setting. 

To turn off actions for a category: 

1. In a view, highlight the category. 

2. Press Flo (MENU) and select Category Properties. 

Agenda displays the Category Properties box (Figure 21-1). 






Actions 


3. Highlight Advanced settings and press SPACE BAR. 

Agenda displays the Advanced Settings box (Figure 21-6). 

4. Highlight Assignment actions. 

5. If the global choice for Assignment actions is On, select Off to 
turn off actions for this category. (If the global choice is Off, 
actions are already turned off throughout the file.) 

6. Press enter twice to return to the view. 

You can turn actions on again for the category by changing 
Assignment actions to On. 



Actions and the Category Manager 


the category manager. This is a convenient method for attaching or 
clearing several actions at the same time. 
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Attaching and To attach or dear more than one action for a category 

Clearing Actions category. 

1. Press F9 (CAT MGR). 


2. Highlight the category and press F6 (props). 
Agenda displays the Category Properties box. 


3. Highlight A 

ssignment acti 

ons and press F3 (CHOICES). 

Agenda displays the Assignment Actions box (Figure 21-7). 

4. Highlight the first category 
SPACE BAR or F7 (INCLCAT). 

to indude in an action and press 

Press SPACE BAR 0 

r F7 (INCLCAT) 

Result 

Once 


The action makes an assignment. 

Agenda displays a plus sign (+) beside 

Twice 


The action breaks an assignment. 

Agenda displays a minus sign (-) beside 

Three times 


Agenda clears the action. 


If you highlight a date or numeric category and press space bar 
once or twice. Agenda displays the appropriate action box. 

5. For a date or numeric category, highlight When items are 
assigned to (category name) also and select one of the following: 

• Assign item to 

• Remove assignment from 

• Clear action 

Change any other settings if necessary and press enter. 

6. Repeat Steps 4 and 5 until you attach or dear all the actions you 

7. Press enter twice. 

Agenda changes the actions as you specify. 
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Figure 21-7 The Assignment Actions box with several 


Displaying Actions By default. Agenda does not display actions (or conditions) in the 
category manager. To turn on the display of conditions and actions 
in the category manager for the current file, you use 
ALT-F7 (SHOW C/A). 

Note To modify Agenda so that it displays conditions and actions 
for all files, use the Utilities Customize command. For more 
information, see Chapter 20. 

To turn on the display of conditions and actions in the category man¬ 
ager, if they are not already on: 

• Press ALT-F7 (SHOW C/A) 

Agenda displays actions next to each category. Assignment, date, and 
numeric actions begin with the letter A followed by an equal sign (=). 
Special actions begin with the letter S followed by an equal sign (=). 

If a category has more than one assignment, date, or numeric action 
attached. Agenda separates the actions with a comma. 


Figure 21-8 shows the Recycling category with two assignme 
actions (Nelson and -Penny), and the Proposal category with 
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Copying Actions You can copy actions from one category to another. Copying actions 
is a quick way to attach the same actions to more than one category. 
If the category has conditions as well as actions, you can also choose 
to copy the conditions when you copy the actions. 

Caution If you copy actions to a category that already has actions, 
the copied actions replace the original actions. 

To copy actions from one category to another: 

1. Highlight the category that has actions to copy. 

2. Press ALT-ts <cpy oa>. 

3. Highlight the category you want to copy the actions to and press 


If the category you copy from has actions only. Agenda copies 
the actions. Skip the rest of this procedure. 

If the category you copy from has both conditions and actions. 
Agenda asks you whether to copy conditions, actions, or both. 
4. Press F3 (choices), highlight your choice, and press enter. 
Agenda copies the actions to the category you specify. 


How Agenda Applies Actions 


If a category with an action has child categories, that action affects the 
child categories as well. For example, you might have the following 
family in your category hierarchy: 

Design 

Sue 


To export items assigned to Sue, Ann, and Tim to a structured file, 
you attach a special action to the Design category. Agenda automati¬ 
cally applies this action to the child categories Sue, Ann, and Tim as 
well as Design. 

If a category or family of categories has more than one type of action 
attached. Agenda uses the following order in applying actions: 





Actions 


• Agenda applies assignment, date, and numeric actions before spe- 

• Agenda applies assignment, date, and numeric actions in the 
order in which they are attached (the order shown in Assignment 

• Agenda applies actions attached to a child category before actions 
attached to the parent of that category. 


Preventing 

Conflicting 

Actions 


When attaching actions, consider how the actions attached to various 
categories interact. In some circumstances, one action can prevent 
Agenda from applying another action. 

For example, you might have the following two actions for the Sales 
category: 


The assignment action assigns items to Status and the second one 
exports items to a structured file. Agenda applies the assignment 
action first and assigns items to Status when they are assigned to 

However, the Status category has a special action that discards items: 
Status S= Discard 

This special action means that as soon as an item is assigned to Status, 
Agenda discards it. Because the assignment action attached to Sales 
(A= Status) causes items to be discarded. Agenda never gets a chance 
to apply the special action (S= Export) that exports items to a struc¬ 
tured file. In other words. Agenda cannot apply the special action 
because it cannot export an item that no longer exists. 


To correct the conflicting actions you change the actions for Sales and 
create another category called Salesexp as follows: 

Sales A= Salesexp, Status 


With these changes. Agenda assigns the item to the Salesexp category 
and to Status according to the action on the Sales category. Then 
Agenda exports the item attached to Salesexp and discards the item 
attached to Status. 



Applying New Actions to Existing Items 


When you enter an item. Agenda assigns it to a category and then 
applies the allegory's action to the item. If you enter a new action for 
a category that already has items. Agenda does not automatically 
apply the new action to these items. To apply new actions to the exis¬ 
ting items in a file, you use the Utilities Execute command. 

Note The Utilities Execute command also applies conditions to the 
items in a file. 


Using the Utilities To apply new actions to existing items: 

Execute Command 

1. In a view, press Flo (MENU) and select Utilities Execute. 
Agenda displays the Execute box (Figure 21-9). 

2. Highlight Apply actions to. 

3. Select Old and new assignments and press ENTER. 

Agenda applies all actions to all items in the file. If the file is large. 
Agenda may take some time to complete this process. 


Setting that controls actions 



Figure 21-9 The Execute be 
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Chapter 22 
Working with Files 


Managing files in Agenda works in much the same way as in many 
other PC applications (such as Lotus 1-2-3). You can create, retrieve, 
or save a file at any point during an Agenda session. You can also 
abandon changes you make to a file or save changes to a different file. 


In this Chapter 

This chapter describes how to: 

• Create and retrieve files 

• Abandon changes to a file 

• Modify and copy files 

• Work with a backup of a file 

• Exchange information between files 

• Customize the defaults for a file 

• Recover a damaged file 

• Display information about the current file 

• Display a list of the external files attached to the current file 
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About Agenda Files 


All Agenda files have the extension .AG. You don't have to include 
this extension when you create or retrieve an Agenda file; Agenda 
automatically adds it to the file name for you. For example, if you 
create a file called PROJECTl, Agenda automatically adds the .AG 
extension, so that the full file name is PROJECTl .AG. 

You can set Agenda to automatically maintain backups of your files. 
Backups have the extension .BG. 

Note You can also create and use several external files with 

Agenda. See the section "Printing a List of External Files" for 
a list of Agenda external files and their extensions. 

Agenda file names have the same character restrictions as DOS file 
names. You cannot use a space or the following characters in an 
Agenda file name: 


When you begin an Agenda session. Agenda displays the file name of 
the last file you worked on, including the path. The path is the loca¬ 
tion of a file on disk and includes the drive letter and subdirectory 
names for the file. The first time you start Agenda, the default file 
name is PLANNER, the Activities Planner Application. 

When you close a file. Agenda automatically saves the changes you 
made. When you retrieve this file, it looks just as it did when you 
closed it. This makes it easy for you to continue your work. 

Note Agenda does not automatically save changes to a file 

retrieved from a network unless you also have the file's reser¬ 
vation. For more information, see Appendix F. 


Creating and Retrieving Files 


ing an Agenda session. 8 yP ° 

If you create or retrieve a file. Agenda saves changes to the current 
file and then closes it before displaying the file you create or retrieve. 
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Retrieving an 
Existing File 


You can create a new file when you start Agenda or while you are 
working in Agenda. 


To create a new file: 

1. Do one of the following: 

• If you are at the operating system prompt, type agenda and 

Agenda displays the File Retrieve box. 

• If you are already in Agenda, press Flo (menu) and select 
File Retrieve. 

Agenda displays the Select File box. 

2. Type a new file name with its path and press ENTER. 

Agenda displays the New File box, which asks for a file descrip¬ 
tion and password. Both of these choices are optional. If you 
want to leave them blank, skip to Step 5. 

3. Highlight Description, type the description (up to forty 
characters), and press enter. 

4. Highlight Password, type a password (up to 12 characters), and 

Caution If you enter a password for the file, be sure to memorize 
the password since you can't display it once you enter it 
and you can't retrieve the file without it. 

Agenda creates, saves, and displays the new file. If you create a new 
file while working in another file. Agenda saves and closes the cur¬ 
rent file before creating the new file. 


You can retrieve an existing file, when you start Agenda or while you 
are working in Agenda. 

To retrieve a file when you start Agenda: 

• Type agenda filename (where filename is the name of the 
file to retrieve) and press ENTER. 
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Shortcuts for 
Retrieving Files 





To retrieve any Agenda file: 


Agenda saves the current file and displays the Select File box 
(Figure 22-1). 

2. Highlight or type a file name and press ENTER. 

Agenda retrieves the selected file. 

To retrieve the previous file used: 

Agenda saves and closes the current file and retrieves the previous 


Saving Changes to a File 


You can save your changes to a file at any point during an Agenda 
session using the File Save command. You can also set Agenda to 
automatically save changes when the keyboard is idle for a certain 
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length of time. 

Agenda also saves changes to the current file when you: 

• Close a file 

• Open a new file 

• Retrieve another file 

• Print all or part of a file or use the Print Setup or Print Preview 
commands 

• Use the System command to exit temporarily to the operating 

• Use the Launch command to run another program without 
quitting Agenda 

• Quit Agenda 

Caution If you end an Agenda session without quitting first. 

Agenda does not save the changes you have made since 
the last save. This might happen, for example, if you 
reboot or turn off your computer in the middle of a ses¬ 
sion, or if you experience a power failure or hardware 
problem during an Agenda session. 

Shortcuts for To quickly save your changes to the current file. 


Agenda saves (writes) your changes to the current file. 

To save your changes and quit Agenda: 

• Press alt-q. 

Agenda saves the changes to the current file and then returns to the 
operating system. 


Saving Changes 
Using the File 
Save Command 


You can use the File Save command to save your changes to the 
current file or to a new file at any point during an Agenda session. 


When you save changes to a new file name, you create two versions 
of the same file, which may be useful for some applications. For 
example, you might want to experiment with some changes before 
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incorporating them into a file. Saving these changes to a new file lets 
you compare the two versions before deciding whether to keep the 


If you save your changes to a new file. Agenda closes the original file 
without saving the changes and opens the new file with the changes. 
To save changes to a file: 

1. Press Flo (MENU) and select File Save. 

Agenda displays the Save File box, which contains the current 
file name as a default and an option to save a backup of the file. 
If you save changes to a backup. Agenda updates the backup if it 
exists, or creates one if none exists. 

To change the default file name: 

• Highlight the name, press F2 (edit) and type the changes. 

To prevent Agenda from making a backup: 

• Highlight Also save backup and choose No. 

2. Press ENTER to save your changes. 

Agenda saves your changes to the file(s) you specify. If you specify a 
new file. Agenda also displays the new file. 


Setting the 

Automatic-Save 

Interval 


To set the automatic-save interval: 

1. Press Flo (MENU) and select Utilities Customize. 

Agenda displays the Utilities Customize box. 

2. Highlight Auto-save interval and type a number between 1 and 
60 to specify the interval in minutes. Press enter twice. 

If you set the interval to 0, Agenda does not automatically save 
the file. 


You can set Agenda to save your changes to the current file automati¬ 
cally if the keyboard is idle for a specified period of time. You do this 
by setting the automatic-save interval. For example, if you set the 
automatic-save interval to five minutes. Agenda saves your changes 
if the keyboard is idle for five minutes. 



Abandoning Changes 


If you don't want to keep the changes you make to a file, you can 
abandon them using the File Abandon command. 

The File Abandon command returns you to the last-saved version of 
a file. If the file has not been saved during the session, the last-saved 
version of the file is the version you retrieved when you began the 
session. 

To abandon changes to a file: 

1. Press fio (MENU) and select File Abandon. 

^daasks if you want to revert to the last-saved version of the 

2. Select Yes and press ENTER. 

The file reverts to the last-saved version. You lose any changes you 
made since you last saved the file. 


Modifying Files 


You can change the file d. 


escription and password for an Agenda file, 
erase Agenda files while working in 


Changing a File 
Description and 
Password 


You can change the description and/or password for the current file 
using the File Properties settings. For example, you might want to 
change the description if it no longer accurately reflects the contents 
of a hie. You might want to change the password (or add a pass¬ 
word) to restrict access to a file. 


To change a file description and/or password: 

1. Press Flo (MENU) and select File Properties. 
Agenda displays the File Properties box. 

2. To change the file description, highlight File de 
new description, and press enter. 

3. To enter a password or change the current pass 
Set file password, and press space bar. 


rfion, type a 
i, highlight 



Agenda asks for a password. 

• If the file does not have a password, type a new password 
and press ENTER. 

• If the file already has a password, type the current password 
and press enter. Then type the new password and press 


Agenda asks you to type the password again to verify it. 

5. Type the password again and press enter. 

If the password does not match the one you typed previously, 
Agenda asks you to start over. Type the password carefully, and 
press ENTER when you are finished. Then type it again and press 

Agenda saves the description and password changes you made. 
Renaming a File You can rename a file to better describe its contents. You cannot 
To rename a file: 

1. Press no (MENU) and select File Retrieve. 

Agenda displays the Select File box. 

2. Highlight or type the name of the file to rename. 

3. Press F9 (rename). 

Agenda asks you to enter a file name. 

4. Type tire new name for the file and press enter. 

Agenda renames the file and displays it in the correct alphabeti¬ 
cal order in the Select File box. 

5. To return to the current file, highlight it and press enter. 

Erasing a File You can erase a file you no longer want by using either the 

File Maintenance Erase command or F4 (DELETE) in the Select File 
box. Erasing a file deletes it from the disk. It does not erase the 


vhile you are working in it. 
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To erase a file using the File Maintenance Erase command: 

1. In a view, press Flo (MENU) and select File Maintenance Erase. 
Agenda displays the Select File box. 

2. Highlight the file to erase and press enter. 

Agenda asks you to confirm your decision to erase the file. 

3. Select Yes and press enter. 

Agenda erases the file from your disk. 

To erase a file in the Select File box: 

1. Press no (MENU) and select File Retrieve. 

Agenda displays the Select File box. 

2. Highlight the name of the file to erase and press F4 (delete). 
Agenda asks you to confirm your decision to erase the file. 

3. Press enter to erase the file. 

Agenda erases the file from your disk. 


Copying Files 


You can make a copy of your current file with a different name using 
the File Maintenance MakeCopy command. You might make a copy 
of your file for any of several reasons: 

• To^keep a number of copies of a file at various stages with differ- 

• To copy a file directly to a disk without exiting to the operating 

Note The File Maintenance MakeCopy command does not copy 
external files. To copy external files, you must use the appro¬ 
priate operating system command. 
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To copy the current file: 

1. Press Flo (MENU) and select File Maintenance MakeCopy. 
Agenda displays the Select File box, which lists the files and 

2. Press ins and type a name for the new copy of the file. 

To copy the file to another directory or to a disk, include the 
complete path with the new file name. 

Caution Do not type an existing file name unless you want to 

3. Press enter. 

Agenda saves the current file and then makes the copy using the 
name you specify and the extension .AG. To work on the new copy 
of the file, you must retrieve it using the File Retrieve command. 
Note To copy the structure of a file without any items or assign¬ 
ments, use the File Transfer Template command. For more 
information about this command, see Chapter 23. 


Copying External An Agenda file can have external files attached to it. These external 
Files files can include note files, macro files, structured files, and named 

print set files. 

When you copy an Agenda file that has external files attached. 
Agenda does not copy the external files. You must copy the external 
files yourself. You can print a list of the external files attached to the 
current file using the Print Final command in the category manager. 
See "Printing a List of External Files" later in this chapter. 


Working with Backups 


You can set Agenda to make a backup of a file automatically when 
you retrieve it, and update the backup each time you retrieve the file. 
You can also make or update a backup of the current file at any point 
during an Agenda session using the File Save command (See "Saving 
Changes Using the File Save Command" earlier in this chapter.) 
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Maintaining 

Automatic 

Backups 


Retrieving 

Backups 


When Agenda ma 
gives the backup 1 
.BG. The backup is 


i backup, it makes a duplicate of your file. It 
une name as the current file with the extension 
red in the same directory as the current file. 


Note 


The automatic backups Agenda i 
place of backing up your files to, 
a disk or a Bernoulli® cartridge). 


To set Agenda to create and maintain an automatic backup: 


% Press Flo (MENU) and select File Properties. 

Agenda displays the File Properties box. 

2. Highlight Make backup on open and choose Yes. Press ENTER. 
The next time you retrieve this file. Agenda makes a backup of the 
file. Agenda then updates the backup each time you retrieve the file. 
Caution If your file becomes damaged and Agenda is set to make 
backups automatically when you retrieve your file. 
Agenda overwrites your undamaged backup with the new 
backup made from the damaged file. If you believe your 
file has been damaged, do not retrieve it. Instead, create a 
new file by using your operating system commands to 
make a copy of your good backup with a new name and 
the extension .AG. (For example, rename PLAN.BG to 
PLAN1.AG.) (See "Recovering a Damaged File" later in 
this chapter.) 


You can retrieve a backup using the File Retrieve command. 

Caution When you retrieve a backup. Agenda copies the backup 
(.BG) over the current version of your file (.AG). At that 
P 0 ' 11 ^ y^ >ur current file (.AG) and your backup (.BG) are 

To retrieve a backup: 

1. Press Fio (menu) and select File Retrieve. 

Agenda displays the Select File box. 

2. Highlight a file that has a backup and press F6 (expand). 
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Agenda displays the files that have the same name but different 

3. Highlight the backup (.BG) and press enter. 

Agenda saves the file and then asks you if you want to replace it 
with the backup (.BG). 

4. Press enter to replace the current file with the backup. 

Agenda deletes the current version of your file, converts the .BG file 
to an .AG file, and opens it. 


Exchanging Information Between Files 


You may want to collect information for an Agenda file while work¬ 
ing in another file. To help you. Agenda provides two pop-up acces- 

• The Items accessory 

You use the Items accessory to enter up to 10 items at a time. You 
transfer these items to a structured file, then import them to your 
Agenda file. 

• The Clipboard accessory 

You use the Clipboard accessory to capture text from one file and 
paste it into an item or note in another file. 

Both accessories are based on the Lotus Metro program. For more 
information, see Appendix C. 


The File Properties Box 


The File Properties box (Figure 22-2) displays all the settings that 
apply to a file as a whole. These settings control many diverse 
aspects of a file. Each setting is described in the appropriate chapter 
of the User's Guide. 






3. Press l 


From now on, every new file you create has I 
current file. 


: default settings of the 


Recovering a Damaged File 


In rare instances, an Agenda file may be damaged during a session. 
To protect your file from further damage. Agenda marks it as dam¬ 
aged, displays the DMGD! indicator in the upper right comer of the 
screen, and displays the Damaged File box (Figure 22-3). 

The Damaged File box gives you the option of saving the file and 
changes to a new file, or simply quitting the damaged file. If you quit 
the file, it does not contain the damaged information, but you will 
lose all the changes you made since you last saved. You can then try 
copying the original file to another subdirectory or checking the hard 
disk or floppy disk for problems before you retrieve the file again. 

If you do not want to lose the changes you have made, you can save 
the file to a new name, although the new file will be damaged and 
needs to be recovered using the File Recovery Utility (DB2STF). 

Note The default name for the new file is the same as the original 
name, but with an at sign (@) suffix. For example, if the origi¬ 
nal file name is MYINFO.AG, the default for the new file is 
MYINFO@.AG. 



Figure 22-3 The Damaged File box 
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To save a damaged file with your changes to a new file: 

1. Do one of the following: 

• Press enter to accept the suggested file name to use for the 
damaged file. 

• To specify a different name, highlight the suggested name, 
type a new name, and press enter. 

2. Highlight Save changes to another file and select Yes (default). 
Agenda displays the Select Hie box. 

3. Do one of the following: 

• Quit Agenda by pressing esc. 

• Select a new file to use and press enter. 

Agenda either returns you to the operating system or displays the file 


For information on exporting the contents of a file, see Chapter 23. 
For information on running the File Recovery Utility (DB2STF), see 


If the Make backup on open setting in the File Properties box is set to 
Yes, you can make a new file from the backup using operating sys¬ 
tem commands. This new file will not contain the changes you made 
during the session in which the damage occurred. 

To make a new file from the backup: 

1. At the operating system prompt, make a copy of your backup 

(.BG) with a new name and the extension .AG (for example, copy 
PLAN.BG to PLAN1.AG). Vy 

2. Start Agenda and 
backup (for exam 
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Displaying File Statistics 


1. In a view, press Flo (MENU) and select File Properties. 

Agenda displays the File Properties box. 

2. Highlight File statistics and press SPACE bar to see information 
about the file. 

Agenda displays statistics about the current file, including: 

Unused space displays the percentage of unused space in the file. 
Agenda allocates space for a file as you add information to it. If you 
discard items and categories, some of the allocated space is no longer 
needed. As the percentage of unused space increases, your file uses 
disk space less efficiently. You can recover unused space by com¬ 
pressing the file. You should do this if the percentage of unused 
space is more than about 25%. 

To compress the file: 

• Press Flo (MENU) and choose File Maintenance Compress. 


Printing a List of External Files 


An Agenda file can have the following external files associated with 

• Macro files (.MAC) 

• Named print set files (.NPS) 

• Note files (No extension assigned) 

• Structured files (.STF) 

If you copy your file to another disk or computer, you should copy 
any attached Agenda external files also, to ensure having a complete 
copy of your file. (The File Maintenance MakeCopy command does 
not copy external files.) 
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To print a list of all the external files attached to the current file: 

1. In a view, press F9 (CAT MGR). 

Agenda displays the category manager. 

2. Press no (MENU) and select Print Final. 

Agenda displays the Print Final box. 

3. Highlight Print and select File info. Then press enter. 

4. Complete the box (if appropriate) and press enter. 

For an explanation of the settings in the Print Final box, see 
Chapter 17. 

Agenda prints information about the current file, including a list of 
external files attached to that file. 


File Size Limits 


The size limit for an Agenda file is approximately 5.5 megabytes. 

(The number of items and categories that this allows is determined by 
the structure of your file.) 


As you approach the maximum si: 
plays the LIMITS! indicator in the 
You can do any of the following to 


ize for an Agenda file, Agenda dis¬ 
upper right comer of the screen, 
a reduce the size of your file: 


• Empty the trash using the Empty Trash setting in the File Proper- 


Compress your file to recover unused space using the File Main- 
tenance Compress command. 

If you have Done items, consider discarding them or exporting 
them to a structured file. (Use the Process Done items setting in 
the File Properties box.) 

Break your file into smaller files by exporting some of the file's 
contents. (See Chapter 23.) 

If you have long notes, store them as external note files. (See 
Chapter 12.) 



Chapter 23 

Importing and Exporting Information 


You can import information into Agenda files to use as items, catego¬ 
ries, and notes. Some of the sources from which you might import 
information include 

• Word processing documents 

• Electronic mail 

• News wire services 

• Lotus Metro List Manager files 

• Other Agenda files 

• The Agenda Items accessory 

Before you import information from an outside source into Agenda, 
you must convert it into an intermediate format called a structured 
file. Agenda provides two utility programs, TXT2STF (Text to Struc¬ 
tured File) and LM2STF (List Manager to Structured File), that per¬ 
form the conversion. 

You can also export information from an Agenda file to a structured 
file, in order to transfer that information into another Agenda file. 


In this Chapter 

This chapter describes how to 

• Convert a text file to a structured file 

A text file can be electronic mail, a word processing document, an 
electronic news wire story, or any other ASCII file from an exter¬ 
nal source that you want to bring into Agenda. 

• Convert a Metro List Manager file to a structured file 

• Import a structured file into an Agenda file 
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• Export part or all of an Agenda file to a structured file 

• Copy the structure of an Agenda file to create a new Agenda file 
■niis chapter covers the basics of importing and exporting informa¬ 
tion with Agenda and default choices for settings you use when you 
import and export information. Chapter 24 covers more advanced 




See also the following chapters in the User’s Guide for additional 
information: 


• Chapter 7, for information about exporting Done items automati¬ 
cally. 

• Chapter 12, for information about importing text into notes and 
exporting notes to note files. 

• Chapter 21, for information about exporting items through a 


Bringing Information into Agenda 


1. Create a structured file by doing one of the following: 

• Convert a text file using TXT2STF 

• Convert a Metro List Manager file using LM2STF 

• Use the File Transfer Export command 

2. Bring the structured file into an Agenda file using the 
File Transfer Import command. 








Common Tasks and Where to Read about Them 


The following table shows the sections in this chapter you should 
read to perform importing and exporting tasks. 

To do the following _ Read these sections in this chapter 

Import a text file into an "Converting a Text File to a Structured File" 
Agenda file and "Importing a Structured File" 

Import a List Manager file "Converting a Metro List Manager File to a 

into an Agenda file Structured File" and "Importing a Structured 


Import a structured file into "Importing a Structured File" 
an Agenda file 

Transfer information between "Exporting the Contents of a File" < 
two Agenda files porting a Structured File" 

Create a structured file from "Exporting the Contents of a File" 
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Converting a Text File to a Structured File 


You use the TXT2STF utility to convert a text file to a structured file. 
You can specify options to control the conversion. Options are words 
you specify when you type the TXT2STF command. They are not 
required, but they provide additional information to TXT2STF about 
how to convert the text file. Figure 23-2 illustrates the flow of infor¬ 
mation from a text file to a structured file. 



f TXT2STF I 
[ utility J 


Structured file 


Figure 23-2 Converting a text file to a structured file 


Note If you plan to convert a file from an external source (for 

example, a word processing document), make sure the file is 
an ASCII text file. Refer to manuals for the software you use 
for information about how to create an ASCII text file. 

If you use the utility without any options, TXT2STF converts each 
new paragraph in the text file into an item, and puts any information 
that does not fit in the item into a note attached to that item. 
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For example, you have a text file (such as a word processing docu¬ 
ment) that contains a list of tasks you have to do this week. Each task 
is a new paragraph in the file: 

Call Bob about Sales demo 
Attend status meeting 
Write proposal for new demo 

When TXT2STF converts the text file into a structured file, it makes 
each new paragraph an item. The structured file for the preceding 
text file contains the following three items: 

• Call Bob about Sales demo 

• Attend status meeting 

• Write proposal for new demo 

For more information, see "How TXT2STF Converts Text Files" later 
in this chapter. 

Using the TXT2STF The following section explains how to use the TXT2STF command. 

Command 

Syntax 

TXT2STF textfile.ext [option(s)] 

textfile.ext is the name of the text file you want to convert. For exam¬ 
ple, if the file name is MEMO.DOC, specify MEMO.DOC for 
textfile.ext. The file must be an ASCII text file. 

Options are described later in this section. 

To convert a text file to a structured file: 

1- Make sine you are at the operating system prompt and in the 
Agenda directory. 

2. Type the TXT2STF command, according to the syntax above. 
TXT2STF displays the TXT2STF copyright box and converts the text 
file to a structured file with the same name and the extension STF. 
Examples 

C:\AGENDA>TXT2STF events.txt 

In the preceding example, TXT2STF converts the text file 

EVENTS.TXT to a structured file called EVENTS.STF. 
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If the text file is not in your current directory, include the path: 
C:\AGENDA>TXT2STF \mail\events.txt 
In the preceding example, TXT2STF converts the file EVENTS.TXT in 
the mail subdirectory. The structured file, EVENTS.STF, will also be 
in the mail subdirectory. 

This conversion does not affect the original text file. 

Options 

Options provide additional information to TXT2STF about how to 
convert the text file. 

[options] are 

• /0=output file 

The /O option lets you specify another name for the structured 
file. See "Specifying a Different Name for the Structured File" later 
in this chapter. 

• /S=separator character 

The /S option lets you specify an alternate separator character for 
paragraphs. The default is a double carriage return. See "Specify¬ 
ing an Alternate Separator Character for the Text File" later in this 
chapter. 

• /D=definitionfile 

The /D option lets you specify a definition file. A definition file 
tells TXT2STF how to interpret the text file. See "Specifying a 
Definition File to Use with the Text File" later in this chapter. 

You can choose to use additional options if you write your own defi¬ 
nition files. These options are helpful in testing a definition file you 
write. For information about writing definition files and the 
additional options, see Working with Definition Files. 
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Guidelines 

Follow these guidelines when you use options with TXT2STF: 

• You must use either a slash (/) or a hyphen (-) before each option. 
Correct: 

C:\AGENDA>TXT2STF events.txt /o=calendar 


How TXT2STF 
Converts Text 
Files 


C:\AGENDA>TXT2STF events.txt o=calendar 

• You can type options in uppercase or lowercase. 

• You can include options in any order. 


If you do not specify a definition file or an alternate separator charac¬ 
ter, TXT2STF converts each paragraph into an item, putting any text 
that does not fit in the item into a note for the item. The conversion 
works as follows: 

• TXT2STF starts at the beginning of the text file, taking text for the 
first item. When TXT2STF reaches a double carriage return (a 
blank line), it ends the item and starts a new item. 

• If there is no double carriage return before the 350th character, 
TXT2STF ends the item at the 350th character (the maximum 
length for an item) and puts the remaining text into a note. 


Specifying a 
Different Name 
for the Structured 


The /O option lets you specify another name for the output (struc¬ 
tured) file. By default, TXT2STF converts the text file to a structured 
file with the same name as the text file. Use the /O if you want the 
structured file to have a different name. Do not specify an extension; 
TXT2STF automatically gives the output file the extension .STF. 
Example 

C:\AGENDA>TXT2STF events.txt /o=calendar 


In the preceding example, the text file EVENTS.TXT is converted to a 
structured file called CALENDAR.STF. 


You can also specify a path with the /O option. 

Example 

C:\AGENDA>TXT2STF events.txt /o=\stf(calendar 
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Separator 
Character for the 
Text File 


To convert a text file to a structured file, TXT2STF uses the default 
carriage return as a separator character. When TXT2STF encounters 
two carriage returns in a row, the utility starts a new item. 


You can use the /S option to specify a separator character other than 
a carriage return, if the paragraphs in your text file are separated with 
a different character. 

Example 

C:\AGENDA>TXT2STF news.txt /s=. 

In the preceding example, the comma (,) is specified as the separator 
character. In this case, each time TXT2STF encounters two commas 
(„) in a row, TXT2STF starts a new item. 

You can use the following as separator characters with the /S option: 

• Any keyboard character, such as a comma (,) or period (.) 

• A three-digit decimal ASCII code preceded by a backslash (\) 

Note To use a backslash as a separator character, you must type 

two backslash characters (s=\\). 


Specifying a 
Definition File to 
Use with the Text 
File 


Examples 

C:\AGENDA>TXT2STF news.txt /s=[ 

The preceding example specifies the left bracket ([) as the separator 
character. 

C:\AGENDA>TXT2STF news.txt /s=\010 

The preceding example specifies the three-digit decimal ASCII code 

for a line feed as the separator character. 


Recall that if you don't specify a definition file, TXT2STF interprets 
each new paragraph in the text file as an item, and puts any informa¬ 
tion that does not fit in the item into a note attached to that item. 
However, you may want the TXT2STF utility to interpret the text file 
differently. A definition file tells TXT2STF how to interpret your 
text file. Figure 23-3 shows the flow of information from text file to 
structured file, using a definition file. 




You don't have to specify a definition file when you convert a text 
file. However, if you do specify a definition file, you have more 
control over how the TXT2STF utility converts your text file. 


without a definition file: 




importing and Exporting Intormatic 


If you want to convert many text files that have the same format, you 
can provide the same definition file (that indicates how to break the 
text into items, categories, and notes) for each text file. 

Example 

You might want to convert a number of memos that have the same 
format to structured files. The text file might look like this: 

Date: December 17, 1990 
To: Jill 
From: Linda 
Subject: Lunch 

Can't make lunch appointment today, can we 
reschedule for next week? 

You can write a definition file that automatically: 

• Makes categories from the names that follow the To: and From: 
labels 

• Makes an Entry date from the text following Date: 

• Makes items assigned to those categories from the text following 
Subject: 

The next section tells you how to specify an existing definition file. 
Unless you are an advanced user or an applications developer, you 
probably don't need to know how to write a definition file. For more 
information, see Working with Definition Files, which provides com¬ 
plete instructions and examples to help you write a definition file. 

How to Use the /D To specify a definition file, run TXT2STF with the /D option and 

Option specify the name of an existing definition file. 


C:\AGENDA>TXT2STF news.txt /d=wirenews.def 
In the preceding example, TXT2STF uses the definition file 
WIRENEWS.DEF when it converts the text file NEWS.TXT. 

C:\AGENDA>TXT2STF news.txt /d=\def\wirenews . def 
You can also specify a path, if the definition file is not in the current 
directory. In the preceding example, TXT2STF uses the definition file 
WIRENEWS.DEF from the def subdirectory. 
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To convert more than one text file into a single structured file, use a 
wild card character to specify a group of files. For example, if you 
have a group of memos with different names, all with the extension 
.MEM, you can convert them into a single structured file by using 
*.MEM as the name of the text file. If you want to place the converted 
files into a single structured file, use the output file option (/O) when 
you run TXT2STF. If you don't use the output file option, TXT2STF 
creates a separate structured file for each text file it converts. 

Example 

C:\AGENDA>TXT2STF *.mem /o=memos 

In the preceding example, TXT2STF converts all files with the exten¬ 
sion .MEM to a single structured file called MEMOS.STF. 


How to Convert 
More Than One 
Text File 


Converting a Lotus Metro List Manager File to a Structured File 


Agenda provides another utility, LM2STF, that lets you convert a 
Metro List Manager file to a structured file. Figure 23-4 illustrates the 
flow of information from a List Manager file to a structured file. 
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Syntax 

LM2STF lislfile 

listfile is the name of the List Manager file. Do not type the extension 
for the List Manager file; the LM2STF utility assumes that the file you 
specify has the extension .US. 

To convert a List Manager file to a structured file: 

1. Make sure you are at the operating system prompt and in the 
Agenda directory. 

2. Type the LM2STF command, according to the syntax above. 
LM2STF displays the LM2STF copyright box and the word Done 
when it has converted the List Manager file to a structured file. 

If the List Manager file is not in your current directory, you can 
include the path. 

Example 

C:\AGENDA>LM2STF \metro\todo 
In the preceding example, LM2STF converts TODO.LIS and 
TODO.NOT (if it exists), into the structured file called TODO.STF. 
The files TODO.LIS and TODO.NOT are in the metro subdirectory. 


Guidelines for LM2STF uses the following guidelines to convert a List Manager file 

Converting a to a structured file: 

List Manager File 

• Notes (if there are any) are converted to notes. 

• Sections are converted to categories, with all items in the section 
assigned to the category. 

• Entry dates are converted to Entry dates. 

• Due dates are converted to When dates. 

The conversion does not affect the original List Manager file. You can 
still use the List Manager file in Metro after you convert it to a struc¬ 
tured file. 



23-14 Importing and Exporting Information 


Types of Agenda Informatio n You Can Import and Export 

An Agenda file has three types of information that you can import 
and export: 

• The data 

The data is the items and notes in your file. 


The structure is the categories and the category hierarchy. 

Agenda exports categories either because you specifically set 
Agenda to export them, or because the categories are part of 
assignments that are exported. Categories that are exported 
because you specifically set Agenda to export them are explicitly 
created categories. 

When you explicitly export categories. Agenda also exports all the 
category properties associated with the categories (including con¬ 
ditions and actions). When you import categories, you import 
these explicitly created categories. 

• The connections between the data and the structure 

The connections are represented by the assignments of items to 
categories. 

In this chapter, the source file refers to the Agenda file you export 
from. The target file refers to the Agenda file you import into. You 
export from a source file to a structured file. You then import the 
structured file into a target file. 


Importing a Structured File 


Once you create a structured file, you can import it into an Agenda 
file. Agenda uses the information in the structured file to create 
items, categories, and notes, and make explicit and conditional 
assignments. 









Summary of Types The following table summarizes the three File Transfer Import 
Of Imported settings you use to import items, categories, and assignments: 


File Transfer 
Import Settings 


Import Items 
Import Categories 


You use the Import Structured File settings to specify the structured 
file you want to import and to indicate how you want to import this 
file. This section covers the defaults, as well as some of the choices 
for the File Transfer Import settings. 

There are many import settings that let an advanced user control how 
Agenda imports information. In most cases, however, you can sim¬ 
ply use the defaults that Agenda provides when you import informa¬ 
tion. This chapter covers only the defaults (and assumes you will use 
them) for the following settings: 

• Categories match if 

• Create unmatched categories used in Assignments 

• Create unmatched categories used in Conditions and actions 
For more information about these settings, see Chapter 24. 

Import from file Identify the structured file from which you want to 
import information. The default name of the structured file is 
TRANSFER.STF (in the same directory as the target Agenda file). 
Agenda displays a message if this file does not exist. 

To select a different structured file, do one of the following: 

• Type a file name (including a path) and press ENTER. 

• Press F3 (CHOICES) to see all your .STF files. Highlight or type the 
name of the file you want to import and press enter. 

Assign to category Specify the category to which you want the 
imported items to be assigned. You can specify a new or existing 
category. Agenda displays the current section head as the default 
category. 



Import Assignments Specify whether Agenda should import 
assignments of items to categories. 


Choice _ Result 


Yes (default) Agenda imports assignments from the structured file into 
the target file. 

No Agenda does not import assignments from the structured 

file into the target file. 


When you choose the default (Yes), if a category in the structured file 
matches a category in the target file. Agenda assigns the imported 
category's items to the existing category in the target file. 
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Typically, you want to choose No (default), in the following 


• If your file is formatted line by line (outlines, mailing addresses, 
and so forth) 

• If the notes in your structured file contain paragraphs that are not 
separated by at least one blank line (two carriage returns), and 
you want to preserve the paragraph divisions. 

If you choose Yes for this setting. Agenda removes single carriage 
returns from notes. Agenda does not remove strings of two or more 
carriage returns. This preserves paragraphs if the imported file uses 
blank lines (two carriage returns) between paragraphs. 

Delete structured file after importing Specify whether you want 
Agenda to delete the structured file from your disk after you import 
it. The choices are No (default) and Yes. 


Exporting the Contents of a File 


The File Transfer Export command lets you export the contents of an 
Agenda file, including items, categories, notes, conditions, and 
actions to a structured file. You can then import the structured file 
into another Agenda file. 

The File Transfer Export command does not export view settings or 


Note If you need to copy views or macros, you can use the File 
Transfer Template command to copy the structure of your 
file, and then import the items and assignments. For more 
information about the File Transfer Template command, see 
"Copying the Structure of a File" later in this chapter. 

You can also use the File Maintenance MakeCopy command 
to make a complete copy of your file with a different name. 
The File Maintenance MakeCopy command copies the items 
and assignments in your file, as well as the structure of the 
file. (See Chapter 22.) 
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To export information: 

1. Start Agenda and open the file from which you want to export 
information. 

2. Press Flo (MENU) and select File Transfer Export. 

Agenda displays the Export Structured File box (Figure 23-6). 
The settings are described in the following section. 

3. Complete the settings and press enter. 

Agenda exports the information you specify to a structured file. It 
records items, categories, and assignments according to the choices 
you specify for the Export Structured File settings. 



File Transfer You use the Export Structured File settings to specify how you want 

Export Settings to export the data, the structure, and the assignments in the source 
file to the structured file. This section covers the defaults, as well as 
some choices, for the File Transfer Export settings. 

There are many export settings that let the advanced user control 
how Agenda exports information. In most cases, however, you can 
use the defaults that Agenda provides when you export information. 





This chapter covers only the defaults (and assumes you will use the 
defaults) for the following settings: 

• Export Assignments 

• Export Categories 

• Record categories referenced in Assignments using 
For more information about these settings, see Chapter 24. 

Recall that in the following descriptions, the source file refers to the 
Agenda file you export from. The target file refers to the Agenda file 
you import into. You export information from a source file to a struc¬ 
tured file. You then import the information from the structured file 
into the target file. 

Export to file Specify the file name for the structured file. The 
default file name for the structured file is TRANSFER.STF (in the 
same directory as the source file). 

To specify a different structured file, do one of the following: 

• Type a file name (including a path) and press ENTER. 

• Press F3 (CHOICES) to see all your .STF files. Highlight or type the 
name of the file to which you want to export information, and 
press ENTER. 

If you specify the name of an existing file. Agenda displays the addi¬ 
tional setting File already exists. 

File already exists Specify what to do if the structured file you 
specify already exists. 


Choice Result 

Append (default) Agenda appends information to the existing struc¬ 

tured file, recording where the new information 
begins. 
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By default. Agenda exports only those categories that have items 
assigned to them. For example, suppose you have an item "Call Alice 
about follow-up meeting," and you assign the item to the categories 
Tasks and Issues. When you export the item. Agenda also exports 
the categories Tasks and Issues, because the item is assigned 
explicitly to them. For each item that Agenda exports. Agenda also 
automatically exports all categories to which that item is explicitly 
assigned. When you choose the default. No, Agenda does not export 
any additional categories. 

If you do not want to choose the default or if you want more informa¬ 
tion about this setting, see Chapter 24. 

Record categories referenced in Assignments using Specify 
how to record the categories specified in assignments in the struc¬ 
tured file. The default is Complete ancestry. 

By default. Agenda exports categories using the full ancestry for the 
category. 

Example 

An item is explicitly assigned to the category High in the source file. 
High is a descendent of the Priority category. The category hierarchy 
looks like this: 

Priority 

High 

Medium 


When Agenda exports the item (and its assignment to the category 
High), Agenda preserves the category hierarchy structure for the 
category High by also exporting Priority as the parent of High. 

If you do not want to choose the default or if you want more informa¬ 
tion about this setting, see Chapter 24. 

Discard items Specify whether Agenda should discard the exported 
items from the source file after exporting them to the structured file. 
The choices are Yes and No (default). If you choose Yes for this 
setting, the items are placed in the trash. You can recover them with 
the Item Undisc command, until the trash is emptied. 

Example 

You may want to discard items from the source file if you no longer 
need them. For example, you mark items in the source file that you 
have accomplished in the past week. You then export the marked 
items into a file called STATUS.STF. You import these items into a 
monthly status report of all tasks you've completed that month. 




23-26 Importing and Exporting Information 


Because you no longer need the marked items in the original file, you 
change the choice for the Discard items setting to Yes to discard the 
items from the original file. 


Copying the Structure of a File 


The File Transfer Template command lets you export the complete 
structure of the current file without any of the items or assignments. 
The new file includes the category hierarchy, views, macros, and con¬ 
ditions and actions from the original file. You might use this com¬ 
mand if you want to share a basic file structure that you have 
developed, and let other users enter their own information. 

To copy the structure of another Agenda file: 

1. Start Agenda and open the file from which you want to copy the 
structure. 

2. Press fio (MENU) and select File Transfer Template. 

Agenda displays the Select File box. 

3. Do one of the following: 

• Highlight the file to which you want to copy the structure of 
the current file. 

Do not select the name of an existing file unless you want to 
erase that file and reuse the name. 

• Type a new file name. 

4. Press ENTER. 

Agenda copies the structure of the current file to the file you specify. 



Chapter 24 

More about Importing and Exporting 
Information 


Chapter 23 introduced you to importing and exporting information. 
This chapter provides additional information about importing infor¬ 
mation into an Agenda file and exporting information from an 
Agenda file. 


In this Chapter 


This chapter describes how to 

• Import a structured file into an Agenda file using choices other 
than the defaults 

• Set up your Agenda file to import a structured file automatically 

• Export an Agenda file to a structured file using choices other than 
the defaults 

Chapter 23 describes the basics of importing and exporting informa¬ 
tion. You should read Chapter 23 before you read this chapter. 

This chapter contains a minimal amount of basic information about 
each setting of the File Transfer Import and File Transfer Export 
commands, in addition to detailed information not covered in Chap¬ 
ter 23. Once you are familiar with the material, you can use this 
chapter as a reference for all the settings. 
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Importing a Structured File 


Recall the steps, described in Chapter 23, to import a structured file: 

1. Start Agenda and open a file. 

2. Press Flo (menu) and select File Transfer Import. 

Agenda displays the Import Structured File box (Figure 24-1). 
The settings are described in the following section. 

3. Complete the settings and press ENTER. 

Agenda imports the specified structured file into the current file. 


File Transfer 

Import 

Settings 



Figure 24-1 The Import Structured File box 


You use the Import Structured File settings to specify the structured 
file you want to import and to indicate how you want to import it. 
This section provides additional information about the 
File Transfer Import choices not covered in Chapter 23. The follow¬ 
ing settings are covered in greater detail: 

• Assign to category 

• Categories match if 
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• Create unmatched categories used in Assignments 

• Create unmatched categories used in Conditions and actions 
Recall that in the following descriptions, the source file refers I 
Agenda file you export from. The target file refers to the Age 
you import into. You export information from a source file to a 
tured file. You then import the information from the structured 
into the target file. 

Import from file Specify the structured file from which you w 
import information into the target file. The default name of the 
tured file is TRANSFER.STF. 

Assign to category Specify the category to which you want the 
imported items to be assigned. Agenda displays the current section 
head as the default category. Agenda always assigns any items in the 
structured file to the category you specify for this setting. 

If Agenda creates new categories in the target file. Agenda uses the 
ancestry specified in the structured file for those categories. Thus, the 
new categories are descendents of the parent specified in the struc¬ 
tured file. However, if the structured file does not specify the ances¬ 
try, then the categories will be children of the category you specify for 
the Assign to category setting. 

Example when structured file specifies ancestry 
The category hierarchy in the target file looks like this: 

MAIN 

Product 

You use the Export Categories setting (one of the File Transfer Export 
settings) to export the category Sales, and its children. 

MAIN 

Sales 

CopyCat 

Rapidfire 

Agenda exports the category Sales and uses this category as the par¬ 
ent for the descendents. When you import the file, the new categories 
(Copycat, Imagic, and Rapidfire) are descendents of Sales, the parent 
specified in the structured file. Sales is a descendent of MAIN. The 
new categories (Copycat, Imagic, and Rapidfire) are not descendents 
of the category you specify in the Assign to category setting. After 
the import, the category hierarchy in the target file looks like this: 


fl|i i! 
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The following two settings control what happens if a category does 
not match. 

Create unmatched categories used in Assignments Specify 
whether Agenda should add categories (specified as part of an 
assignment) from the structured file to the target file if the categories 
do not match existing categories in the target file. 


Yes (default) 


Any category (specified as part of an assignment) ir 
the structured file that does not match an existing 
category in the target file is added as a new cate¬ 
gory. Items assigned to the category in the struc¬ 
tured file are assigned to the new category in the 
target file. 


of an assignment) that does not match an existing 
category in the target file is ignored. If items are 
assigned to the category, those assignments are 
ignored. The items are assigned only to the cate¬ 
gory specified in the Assign to category setting and 
to any other categories that match. 


Whether or not categories match is determined by the Categories 
match if setting. By default, two categories match if they have the 
same category name. For example, the Anna Lasky category matches 
Anna Lasky, but not Anna. 

If Agenda creates any new categories, it creates them in the target file 
using the same ancestry as specified in the structured file. 

Example using the default 

The item "Call Mary about Copycat Demo" is assigned to the Copycat 
category, which is a child of the Sales category. Sales is a child of 
MAIN. The category hierarchy in the source file looks like this: 


Sales 

Copycat 

By default. Agenda records the full ancestry for Copycat in the struc- 
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Whether categories match is determined by the Categories match if 
setting. By default, two categories match if they have the same 
category name. For example, the Anna Lasky category matches Anna 
Lasky,, but not Anna. 










You may want to override the default if you do not want to change 
the structure of the target file. If you choose No for the Create 
unmatched categories used in Conditions and actions setting. 
Agenda does not add categories that are referred to in conditions and 
actions to the target file. However, Agenda still matches categories 
in the structured file to existing categories in the target file. 

Agenda displays the Create unmatched categories used in Condi¬ 
tions and actions setting if you choose Yes for Import Categories. 
Strip carriage returns Specify whether Agenda should eliminate 
single carriage returns from notes. The choices are Yes and No (de¬ 
fault). 

Delete structured file after importing Specify whether you want 
Agenda to delete the structured file from your disk after you import 
it. The choices are Yes and No (default). 


Summary of The following table summarizes the defaults for the File Transfer 

Import Settings Import command: 
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Importing a You can set up your Agenda file to import information automatically 

Structured File every time you open the file. You might want to automatically 

Automatically import a structured file to which you (or other people) append infor¬ 

mation on a regular basis. Agenda imports just the new data from 
the file. See "Importing Only New Data” later in this chapter. 

There are several ways to create structured files that you might want 
to import automatically: 

• You can use the Items accessory to enter items for Agenda while 
running another program. The Items accessory appends the items 
to a structured file. (See Appendix C.) 

• You can attach a special action to a category to export all items 
assigned to the category to a structured file. (See Chapter 21.) 

• You can use the File Properties command to export items to a 
structured file as soon as they are designated as done. Under 
Global date settings, select the Export to Done file choice for the 
Process Done items setting to export items to a structured file as 
soon as they are designated as done. (See Chapter 7.) 

• You can append to or replace an existing structured file with the 
File Transfer Export command. 

To select a structured file to be imported automatically: 

1. Start Agenda and open the file into which you want to import a 
structured file automatically. 

2. Press Flo (MENU) and select File Properties. 

Agenda displays the File Properties box. 

3. Highlight Auto-import file and do one of the following to select 
a structured file: 

• Type a file name and press enter twice. 

• Press E3 (CHOICES) to display the files in the current directory. 
Highlight or type the name of the structured file you want to 
import and press ENTER twice. 

You can specify a path with the file name. 

Agenda imports the file you specify each time you open the Agenda 
file. Even if you change the File Transfer Import settings. Agenda 
always uses the following choices for importing a structured file 
automatically: 
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Import setting Default 

Assign to category MAIN 

Strip carriage returns No 

Delete structured file after importing No 


Importing Only If you specify a structured file to be imported automatically (or if you 

New Data use the Import New data only setting under the File Transfer Import 

command). Agenda imports only the information added to the target 
file since the last time the structured file was imported. If it is a 
structured file with the same name, but with completely new con¬ 
tents, Agenda imports the entire contents of the structured file. 

To do this. Agenda keeps track of when and where information was 
added. In order to ensure that this works correctly, follow these 
guidelines: 

• Do not edit or retype the structured file name you initially speci¬ 
fied for the Auto-import file setting under the File Properties 


• Do not edit or retype the structured file name you initially speci¬ 
fied for the Import from file setting under the File Transfer 
Import command. 

• Do not edit the structured file except to append new data. 


Exporting the Contents of a File 


Recall the steps, described in Chapter 23, to export the contents of a 


1. Start Agenda and open the file from which you want to export 
information. 

2. Press Fio (MENU) and select File Transfer Export. 

Agenda displays the Export Structured File box (Figure 24-2). 
The settings are described in the following section. 
















rt this item using Export all assignments as explicit. Agenda 
•ds the assignment between the item and the Sales category as an 
dt assignment in the structured file. Then you import the struc- 
l file into an Agenda file and edit the text of the item to "Call Jim 
and Mary about demo meeting.'' The item is still assigned to the 
ory Sales because the assignment is now explicit, even though 



assigned to them. 

When you specify categories to be exported, the category properties 
are also exported. Category properties include the settings in the 
Category Properties box, such as the category type, conditions and 
actions associated with the category, and whether the category has 
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By default. Agenda does not export any categories, 
that have items assigned to them. If you choose N 
are created by item assignments are still exported: 

• If you choose Export explicit assignments only 
Assignments setting. Agenda exports categories 
explicitly assigned to them. 


, except categories 
b, categories that 


for the Export 
s that have items 


• If you choose Export all assignments as explicit, Agenda exports 
categories that have items conditionally assigned to them, in addi¬ 
tion to categories that have items explicitly assigned to them. 

Note The properties (conditions and actions, and so forth) of these 
categories are not exported. To export category properties 
along with categories, you must explicitly export categories 
by choosing Yes for this setting. 

You use the default. No, when you want to export items and assign¬ 
ments, but do not need to export the structure of the file. If you want 
to export the structure of a file, either with or without items and 
assignments, choose Yes. The structure of a file includes categories, 
the relationships between the categories (as represented by the cate¬ 
gory hierarchy), and the category properties (including conditions 
and actions). 


Example 

The source file has a Departments category that has the following 
descendents and conditions. 


Departments 
Sales C= Jim,Barbara 
Admin C= Robert,Sandy 
Development C= Stevejackie 
Fund-Raising C= Bill,Anna 

If you choose Yes, Agenda prompts you for the family of categories 
you want to export. If you choose to export the Departments cate¬ 
gory, the following are exported to the structured file: 

• The Departments category and its properties 


The descendents (Sales, Admin, Development, and 
and their properties 


1 Fund-Raising) 




Export Category and children of S] 

lies you want to export. You specify I 
for the family. The default is MAIN, 
name, or press F3 (choices) to see the 
different category. 

Agenda displays this setting if you ch 
Export Categories setting. 


Record categories referenced 
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If you import this structured file into another Agenda file with the 
same category hierarchy, the items in the structured file assigned to 
the category High under Priority are assigned to High under Priority 
in the target file. The items assigned to High under Trading volume 
are assigned to High under Trading volume. 

If you choose Category name only, you would not have any way to 
ensure that the items are assigned to the correct High category. 
Agenda assigns the items to the first High category that it finds. 
Example using Category name only 





• When you import a structured file created using the Complete 
ancestry choice, items from the structured file are assigned to cate¬ 
gories in the target file only if both categories have the same 
ancestry. 

• When you import a structured file created using the Category 
name only choice, items from the structured file are assigned to 
any matching category in the target file, regardless of the ances¬ 
tors of either category. 

Record categories referenced in Conditions and actions using 

Specify how to record the categories specified in conditions and 

actions in the structured file. 


Choice _ 

Complete ancestry 
(default) 

Category name only 


Exports the specified category with its entire 
Exports the category without its ancestry 


If you choose Complete ancestry. Agenda records the ancestry of the 
category in the structured file, along with the category name. The full 
ancestry remains a part of the category. If you choose Category name 
only. Agenda records the category name only, without its ancestry. 
Discard items Specify whether Agenda should discard the exported 
items from the source file after exporting them to the structured file. 
The choices are Yes and No (default). 


Summary of 

Export 

Settings 


The following table summarizes the defaults for the File Transfer 
Export command: 




TRANSFER.STF 

Export explicit assignments only 


Export Items 
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Export Setting Default 


Export Category and MAIN 

children of 

Record categories Complete ancestry 

referenced in Assignments 

Record categories 
referenced in Conditions 


Complete 
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abandon Discard all changes that you made since the last time you 
saved the current Agenda file and revert to the previously-saved 
version. 

absolute date A date and/or time that does not depend on the cur¬ 
rent system date. For example, "November 1" is an absolute date 
(whereas, "next Monday" is not an absolute date). 

accelerator keys Keystroke combinations using the alt key with 
an alphabetical key that provides shortcuts for performing Agenda 
tasks. For example, ALT-Q saves your file and quits Agenda. 

accessory A pop-up program that you can call up on the screen 
without quitting the program you are currently running. Agenda 
supplies two accessories that let you enter information: the Items 
accessory (for storing information to use as items in Agenda) and the 
Clipboard accessory (for copying text from another application to 
paste into an Agenda item or note). Two other accessories (Kaleido¬ 
scope and Configuration) allow you to customize these accessories. 

action An instruction you attach to a category. An action directs 
Agenda to process items a certain way when they are assigned to the 
category with the action. There are four kinds of actions: assignment 
actions, date actions, numeric actions, and special actions. Actions 
make explicit assignments. 

Agenda database An Agenda file from an earlier release of Agenda 
(either 1.0 or 1.01). An Agenda database consists of two files with the 
extensions .AGA and -Adi 

Agenda file A collection of text (items, notes, and macros) with 
structure (categories and views). An agenda file has the extension 
.AG. 



i the column head. 


ASCII (American Standard Code for Information Interchange) 

ASCII is the standard set of codes that many computers and commu¬ 
nication devices use to exchange information. You can import an 
ASCII file into an Agenda note or macro and export Agenda text 
from an Agenda note or macro to an ASCII file for use with other 
software. 

ASCII file A file that contains text without special formatting codes. 

assignment The connection between an item and a category. Each 
time you enter an item, you assign it to a category. You can assign an 
item to many categories; many items can be assigned to one cate¬ 
gory. See also conditional assignment, explicit assignment. 

assignment action An action that directs Agenda to assign an item 
to (or remove an item from) one or more categories. For example, if 
Gina is in charge of Sales, you can attach an assignment action to the 
Sales category that automatically assigns all items to the Gina cate¬ 
gory when they are assigned to Sales. An assignment action is also 

assignment condition A condition that directs Agenda to assign an 
item to a category if it is already assigned (or not assigned) to another 
category. For example, you have a category called Prospects and you 
want to assign only those items that are already assigned to a per¬ 
son's name and telephone number to the Prospects category. You 
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create an assignment condition for Prospects specifying that the item 
must already be assigned to the Name category and the Phone # cate¬ 
gory before Agenda assigns it to Prospects. Thus, all items assigned 
to the Name and Phone# categories will be assigned to the Prospects 
category. 

assignment profile The list of categories to which the current item 
(or marked items) is assigned. The assignment profile displays both 
explicit and conditional category assignments. You can display, add, 
or remove category assignments in the assignment profile for a single 
item or a group of marked items. 

attach (1) Specify a filter, condition, or action. See also filter, condi¬ 
tion, action. (2) Specify an external file (note, macro, or named print 
set file) to use with the current note, macro, or view. See also macro 
file, named print set file, note file. 

attribute A characteristic of printed text. Bold, italic, and normal are 
all attributes. 

attribute marker A marker that you can insert in text to print a spe¬ 
cific region of text with attributes different from the current one. An 
attribute marker lets you add emphasis such as bold or italic to a 
word or phrase. You can also apply attribute markers to marked 
regions of text. 

auto-import file A structured file that Agenda imports each time 
you open an Agenda file. 

automatic assignment The process by which Agenda assigns an 
item to a category based on the conditions and actions in the category 
hierarchy. By default. Agenda automatically assigns an item to a 
category if the item's text includes the category name (a text 


automatic completion The process by which Agenda tries to match 
what you type with choices that are currently available. Automatic 
completion takes place when you are entering categories in a view or 
making selections from a list. 

backup A duplicate of your Agenda file with the same file name 
and the extension .BG. You can set Agenda to make a backup file 
automatically (or update one if it already exists) when you retrieve an 
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calculation label The labels (such as TOTAL) at the bottom of the 
section or sections for the calculations you specify in a numeric 
column. 


category One or more words that you use to group related items. 
You organize items by assigning them to categories. Assigning items 
to categories is like filing them in folders. 


category column A column in a view that displays categories as 
well as date, numeric, or text values, or other information about an 
assignment. See item column. 


category filter A restriction that lets you display in a view only 
those items that are assigned (or not assigned) to one or more speci¬ 
fied categories. 


category hierarchy A list of all the categories in the current file that 
shows how these categories relate to each other. You can display and 
work with the category hierarchy in the category manager. 






see the item(s) caught in a circular reference, 
clear Delete all text in the current macro or note. 

Clipboard accessory A pop-up accessory that lets you copy text 
from another application and paste it into an Agenda item or note. 

collapse In the category manager, display only parent categories 







compose sequence A series of characters that you type after you 
press ALT-Fl (COMPOSE) to produce a character that is not on the 
keyboard. 

compress Recover unused space in a file with the File 
Maintenance Compress command. Select the File Properties com¬ 
mand, highlight File Statistics, and press space bar to see how much 
unused space is in the current file. 

condition An instruction you attach to a category. A condition 
directs Agenda to assign items to a category if they meet the condi¬ 
tion attached to that category. There are four kinds of conditions: 
text conditions, assignment conditions, date conditions, and numeric 
conditions. Conditions make conditional assignments. 

conditional assignment An assignment of an item to a category 
that Agenda automatically makes based on a condition. Conditional 
assignments are broken if the item no longer meets the condition. 

Configuration An Agenda accessory that lets you customize the 
amount of memory set aside for the accessories and configure the 
accessories for your specific hardware needs. 

confirm mode A method of operation that prompts you to confirm 
that you want to perform a task you select, for example, when you 
make changes that delete information. You use the Utilities 
Customize command to turn Confirm mode on and off. 

control sequence A series of characters that is sent to your printer 
to perform certain specialized printing tasks, such as changing print 
colors for color printers. 

conventional memory The amount of RAM within the first 640K 
that the operating system makes available to application programs 
such as Agenda. This amount does not include extended or 
expanded memory. 

copy Copy text so you can past it elsewhere. (Agenda temporarily 
stores this text.) You can copy text when editing in an item, category. 


cursor In a note or macro, or when editing an item, the reverse 
video rectangle that indicates the location of your next action or the 
next character you type. 





descended A category at a lower level in the category hierarchy 
within the same family. For example, in the following family of cate¬ 
gories, Robert, Teresa, and Douglas are descendents of all the catego¬ 
ries at a higher level (Sales, Staff, and Company): 

Company 

Staff 

Teraa 

Douglas 


destination file See target file. 
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font marker A marker you insert in Edit mode to print a specific 
region of item, note, or header and footer text with fonts different 
from the current font. You can also apply fonts to marked regions of 


footer Line(s) of text that you can print at the bottom of each page. 

function keys The fi through Flo, alt-fi through alt-fio, ctrl-fi 
through cfrl-fio and SHin-n through SHIFT-Fio keys that you can 
press to perform tasks. 

function key map The legend at the bottom of the screen that dis¬ 
plays the current meaning of each function key. You can turn the 
display of the function key map on and off by pressing alt-k. 

global protection See protection. 

header Une(s) of text that you can print at the top of each page. 

highlight The reverse video bar that indicates your place on the 
screen or marked text. See marked text. 


immediate child Inafamilv 


ateeories. a cateeorv that is a dired 





immediate parent In a family of categories, the parent category that 
is a direct descendent to its child categories. In the category hierar¬ 
chy, the immediate parent is outdented above its children. For exam¬ 
ple, in the following category family, the category People is the 
immediate parent of the child categories Loretta, Sam, and Nicholas. 
Staff is the immediate parent of People. 

Staff 

People 

£L 

import (1) Bring information in a structured text file (STF) into an 
Agenda file. (2) Bring a text file into a note or macro. 

inherited assignments Assignments that occur when the items 
directly assigned to a child category in a family are also assigned to 
any ancestor. For example, in the following category family, the par¬ 
ent category. People, inherits the items assigned to Loretta, Sam, and 
Nicholas. 

People 

Loretta 

Sam 

Nicholas 

A section includes all items that are either directly assigned or inher¬ 
ited by the category used as the section head. 

Initial Section The section head category that Agenda automatically 
creates for you when you open a new file. 

Initial View The view that Agenda automatically creates for you 
when you open a new file. Agenda automatically creates the section 
head Initial Section in the Initial View. 

item The basic unit of information in Agenda. An item can be a few 
words or a more lengthy description of an idea, a concept, or a spe¬ 
cific task. Each item can be up to 350 characters long. Each item is 
assigned to at least one category. 

item column A section head and the items assigned to the section 
head category. See also category column. 


I tag The character to the left < 









saves space in your Agenda file, and/or lets you maintain an ongoing 
exchange of information between Agenda and another application. 


numeric action An action that assigns numbers to the items 
assigned to a category. A numeric action can also break the assign¬ 
ment of a numeric category with the items assigned to the current 
category. 

numeric category A category you use to display numbers (such as 
Cost or Amount) that you can use to perform calculations. 


numeric condition A condition that tells Agenda to assign to a cate¬ 
gory items that have a certain number, or numbers that fall inside (or 
outside) a certain range. For example, you can attach a numeric 
condition to the High Priority category that pulls in all items with 
Expenses over $200. 

numeric filter A filter on a numeric category that displays any items 
that fall within (or outside of) a range of numbers that you specify. 
For example, you can display all expenses over $10,000. 

numeric values A number you enter in a numeric column that 
assigns the adjacent item to a numeric category. The numbers in a 


I 


opt i O n s Choices you specify when you type the TXT2STF com¬ 
mand. Options provide additional information to TXT2STF about 
how to convert the text file. 
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page A block of 16K of expanded memory. 

page swapping The process by which Agenda copies (or swaps) the 
contents of a page of expanded memory into conventional memory. 
The standard amount used for page swapping is 64K (equal to four 
pages). 

parent In a category family, the category that includes the child 
categories under it. This category often describes or summarizes the 
child categories under it. In the following category family, the cate¬ 
gory People is the parent. 

People 

Loretta 

Sam 

Parent:Category A column format that displays the name of the 
category to which the adjacent item is assigned, preceded by the 
name of its parent. 

paste In Edit mode, the operation that places the most recently-cut 
or copied text in an item, note, or macro. 

path The root directory and all the subdirectories in which you save 
a file. A path name consists of the drive letter and one or more subdi¬ 
rectory names, for example, C:\AGENDA\APPS. 

portrait The mode of printing when the page is longer than it is 


prerequisite item An item that must be completed before another 
item (the dependent item). 
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Sibling A child category with the same parent on the same family 
level. For example, in the following category family, Loretta, Sam, 
and Nicholas are all siblings (but Oak is not a sibling of Loretta, Sam, 
or Nicholas): 

People 

Loretta 

Nicholas 

Trees 

Oak 

sort characteristic The criteria that you can use to sort items, sec¬ 
tions, and categories, such as alphabetical order. See also primary sort 
key, secondary sort key. 

source file The Agenda file you export information from. 

special action An action that does one of three things to the items 
assigned to a category: discard them, export them, or designate them 


special marker See marker. 

standard category Any category you create until you change it to 
another category type. By default, a standard category can have 
children. 


standard view Any view that is not a datebook view. 

Star A column format which displays a star (*) for items assigned 
(either directly or through inheritance) to the category used as the 
column head. You can assign and break assignments of items to cate¬ 
gories by adding and removing stars in the column. 

structured file A text file that includes tags to separate the text in a 
file into items, categories, assignments, notes, and other information. 
Structured files have the extension .STF. You can create a structured 
file from all or part of your Agenda file with the File Transfer Export 
command. You can create a structured file from information outside 
of Agenda with the utilities TXT2STF and LM2STF. You can import a 
structured file into Agenda with the File Transfer Import command. 

swap To copy the contents of a page of expanded memory into con¬ 
ventional memory. 
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Symbol A character on the screen that gives you information about 
your file. For example, a symbol (J“) displays next to an item with a 


target file The Agenda file you import information into. 

terminate-and-stay-resident program (TSR) A software program 
that runs in the background while you use another program such as 

text condition A condition that tells Agenda to assign items to a 
category if the item and/or note text includes certain words or 
phrases. For example, you can attach a text condition that assigns 
items that include the word "taxes" to the category Accountant. By 
default, a category name is also a text condition; Agenda assigns 
items to a category if the item and/or note text includes the category 


text file Any ASCII file from an external source that contains infor¬ 
mation that you want to bring into Agenda. 

text matching Agenda's ability to match items to categories if cer¬ 
tain words (for example, the category name) appear in the item 
and/or note text. See also text condition. 


text values Letters and/or numbers such as part numbers i 
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unindexed category A category you create to store unique informa¬ 
tion such as a person's address or phone number. 

unindexed column A column used to display text values that are 
any combination of letters and numbers such as invoices or part num¬ 
bers. An unindexed column consists of an unindexed category used 
as a column head and column entries that are text values. The text 
values in unindexed columns are not categories. 

view A screen that lets you display and enter information in an 
Agenda file. A view contains one or more sections. A file can 
contain many views. 

view filter See filter. 

view manager A list of all the views in your file. You can use the 
view manager to add, delete, and sort views as well as to modify 
view properties. 

virtual memory Any available memory in your computer that is 
used as RAM during printing. This includes conventional memory, 
expanded memory, and available memory on a hard disk. 

When date A date you enter for an item or a date Agenda interprets 
from the text of an item. It can be a due date for a report, a start date 
for a project, or any crucial date you want to keep track of. 

Yes/No A column format which displays a Y opposite each item that 
is assigned (either directly or through inheritance) to the category 
used as the column head and an N opposite each item that is not 
assigned to that category. You can assign or break assignments of 
items to categories by typing Y or N in the column. 
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Appendix A 

Agenda Menu Commands 


The following diagrams show the commands for the view menu 
and macro menus, print preview menu, and category manager 


View Menu 




A-2 Agenda Menu Commands 

Note and Macro Menus 



Print Preview Menu 




Appendix B 

Agenda Indicators and Symbols 


Agenda displays indicators and symbols on the screen to give you 
status information and information about your file. 


In this Appendix 


This appendix describes 

• Mode and message indicators 

• Symbols 


Mode and Message Indicators 


Mode and message indicators are short descriptions that generally 
display in the upper right corner of the screen. They either tell you 
about modes you're in, such as EDIT, or give you status messages, 
such as WAIT or WRKG. 

The following table describes the mode and message indicators. 
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DMGD! 

EDIT 

INS 

LEARN 


The disk is full; you must exit Agenda and free up more 
disk space. Agenda automatically turns off conditions 


The current file is damaged. (See Chapter 22.) 

You are editing the text of something (item, note, cate¬ 
gory name, or macro) and can use the editing keys. (See 
Chapter 14.) 


You are in Learn mode; Agenda is 


ling your key- 


LIMIT! 

OVR 

READONLY 


The file is approaching its maximum size; you should 
avoid adding more information (or delete information 
you don't need). 

You are overwriting characters (opposite of insert (INS)) 
in a note or on the Macro edit screen. 

You can only read the file (usually displays in a file you 
retrieve from the network). You cannot save any 
changes you make to the file. Displays beside the file 
name after you open the file. 

Agenda is working on a task and must complete it 
before starting another. 

Agenda is working on a task in the background. You 
can continue doing other work in Agenda. Agenda 
interrupts the background task to carry out your 


Symbols 


Symbols are special characters you see on the screen. They tell yov 
about the characteristics of items and categories in your file. For 
example, if an item is marked for further tasks. Agenda displays a 
symbol (♦) beside the item. 



View Symbols 




The file is set to not display inherited items 
a (items that are assigned to a descendant of the 
section head category). 


■ The file is set to not display items that depend 
i on other non-done items or those that depend 
on the completion of other items. 


The view or section has a filter attached, 
which displays only those items assigned to 
this category. 


[category] Upper right co 
ner of the scre€ 


[-category] Upper right cor- The view or section has a filter attached, 

ner of the screen which displays only those items not assigned 
or right of to this category. 
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Category Manager 
Symbols 


Note For information on date and numeric ranges, see "Value 
Range Symbols" later in this appendix. 


The following table describes the symbols in the category manager. 


Notes In the category manager. Agenda displays individual symbols 
only if they are not set to the global choice in the Category 
Properties box or the Advanced Category Properties box. 

Although date, numeric, and unindexed categories can have 
notes and note files attached, the musical note and double 
musical note symbols do not display in the category manager. 


If you see Here It means 


Left of category The category has a note. 

Left of category The category has a note file attached. 

Left of category The category is a date category. 

Left of category The category is a numeric category. 

Left of category The category is an unindexed category. 
Right of The category is protected. (Advanced Cate- 

category gory Properties settings). 

Right of The category is not protected. (Advar 

category Category Properties settings). 

Right of The category mnnot have new childrei 

category _vanced Category Properties settings). 








ategory can have new children. (Ad- 
d Category Properties settings). 

in old assignment. Agenda keeps the old 
[Advanced Category Properties set- 


:w assignment to this category conflicts 
ne. (Advanced Category Properties set- 


itegory has children not shown because 
erarchy is collapsed. Press ALT - and 
to expand and collapse the family. 
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If you see 

Here 

It means 

S= Done 

Right of 

Special action that designates items as done 
when they are assigned to a category. 

S= Export 

Btightof 

category 

are assigned to a category. 

S= Discard 

Right of 

Special action that discards items when they 
are assigned to a category. 

T= Item 

Right of 

Match on items. 

T= Note 

category 

Match on notes. (Advanced Category Proper¬ 
ties settings). 

T= Both 

Right of 
category 

Match on both items and notes. (Advanced 
Category Properties settings). 

T =n% 

Right of 
category 

Required text match strength for the category 
is set to this percentage (100% specifies exact 
matching; 50% partial matching; 2% minimal 
matching). (Advanced Category Properties 
settings). 

T= ? 

Right of 

Agenda prompts for confirmation before 
assigning items to the category. Use the 
Utilities Questions command to display the 
suggested assignments. (Advanced Category 
Properties settings). 

T=~? 

Right of 
category 

Agenda does not prompt for confirmation 
before assigning items to the category. (Ad¬ 
vanced Category Properties settings). 


Right of 
category 

Right of 
category 

You can enclose in parentheses a phrase 
whose word order you want Agenda to 

Separate text conditions with semi-colons (;) 
when you want any of the attached text condi- 


Right of 
category 

when you want allot the attached text condi- 


Enclosing texl 

t Do not match on enclosed text. 

A 

Before text 

Match on suffixes. 








Macro Manage 
Symbols 
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Value Range When you use date/numeric filters, date/numeric conditions, or 

Symbols date/numeric actions, you can specify a range of values for them. To 

display these ranges on the screen. Agenda uses the symbols shown 
in the following table. 

Note Actions and assignments in the Item Properties box have only 
category(z?fl/ue); conditions and filters can have catego- 
ryirange). 


category(start<-4end) 


category(start<->) 

category(<->end) 


category-(start<->end) 


Greater than or equal to the start of the range AND 
less than or equal to the end of the range 
Greater than or equal to the start of the range 
Less than or equal to the end of the range 
Numeric: exact value; Date: within value; for exam¬ 
ple, if value is Today, any time within Today is valid. 
Less than the start of the range OR greater than the 
end of the range; that is, NOT(start«->end) 


category-(start<->) Less than the start of the range; that is, NOT(start<-») 

category-(<-»end) Greater than the end of the range; that is, 

NOT(f*end) 


category-fzwiu 
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Using the Agenda Accessories 


The Agenda accessories are pop-up programs that let you capture 
and store information for items, categories, and notes while working 







Using the Agenda Accessories 


In this Appendix 


This appendix describes 

• How to prepare to use the Agenda accessories 

• How to use the Items accessory 

• How to use the Clipboard accessory 

• How to use the Kaleidoscope accessory 

To install the Agenda accessories, see Chapter 1 in Setting Up Agenda. 


Preparing to Use the Agenda Accessories 


To use the Agenda accessories, you must first run Metro. This 
requires 65K of RAM memory. 

Note If you are using DOS 4.0, some tenminate-and-stay-resident 
programs won't run, including the Agenda accessories. 
There is one Help screen for each Agenda accessory. To see a Help 
screen while working in any of the accessories: 


Loading Metro To load Metro: 

• From your operating system prompt, type met ro and press 


Notes You should load Metro after loading any other terminate-and- 
stay-resident applications (TSRs) that you have. This includes 
IBM International Keyboard Drivers. 

If you have difficulties loading Metro, see "Changing Memory 
Allocation and Display Drivers” later in this appendix. 
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Unloading Metro You can unload Metro from memory at any time as long as no other 
software is being run. This will make more memory available for 
other applications. 

To unload Metro: 

• From your operating system prompt, press alt-shift-end. 

If you hear a beep while pressing these keys, that means that Metro 
cannot be unloaded from memory. This might happen if you are 
running another terminate-and-stay-resident program above Metro. 
In this case, you will have to reboot your computer to unload Metro. 
To verify that Metro has been unloaded, press alt-shift; the Metro 
Accessories menu should not be displayed. 

Note If you unload Metro and you have information on the Clip¬ 
board, the contents of the Clipboard will be lost. See Using 
the Clipboard" later in this appendix. 


Changing Memory The version of Metro provided with Agenda includes default settings 
Allocation and for memory allocation and display. You can run the Agenda accesso- 

Display Drivers ries without reconfiguring these settings. 

However, you may need to configure Metro for your specific hard¬ 
ware and/or software needs. For example, you can change the 
amount of memory allocated for Metro (to put more information into 

do this using the Configuration accessory. 

To change the memory allocation and display drivers: 

1. Press ALT-SHIFT-?. 

2. Press Flo (MENU) and select Configure. 

The Configuration accessory displays various settings that let 
you customize Metro for your specific hardware and software 
needs. These settings are described below. 

3. Complete the settings and press Flo (MENU), then select Quit. 


For your changes to take effect, you must unload Metro and then 
reload Metro. 


You use the Configure settings to customize Metro for your specific 
hardware and software needs. 

Memory Size Specify the amount of memory you want to use for 
the Agenda accessories. 


Configure 

Settings 
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You can specify from 64K to 265K if the Swap Y/N setting is set to 
Yes. Specify 125K to 512K if the Swap Y/N setting is set to No. To 
run the Agenda accessories at the same time that you run Agenda, 
you should specify a memory size of no more than 75K. 

Color (Y/N) Specify the color to display the Agenda accessories. 

The choices are Yes and No (default). Select No for a monochrome 
monitor or Yes for a color monitor. 

Suppress Snow Specify whether to suppress snow. The choices are 
Yes and No. 

Select Yes if you are using a CGA monitor and snow is a problem. 
Display Driver Specify the display driver to use. 

To select a new display driver, press ENTER. Metro lists the display 
driver choices. Press T and 4- to scroll through the choices and to see 
a description of each choice. Highlight the driver that you want to 
use and press ENTER. The default is UNI.SDR. 

Macro Memory Specify the amount of memory that you want to 
allocate to Metro macros. Use this setting only if you have the full set 
of Metro Macro accessories installed. The default is 3K. 

Swap (Y/N) Specify whether you want memory to be temporarily 
swapped to disk if the Agenda accessories require additional 
memory. The choices are Yes (default) and No. 

Swap Directory Specify the directory in which the Swap files 
should reside. The default is C:\METRO\SWAP.DIR. (Use only if 
you select Yes for Swap (Y/N).) 

Swap Memory Size Specify the amount of memory that should be 
allocated as a swap area. It must be between 128K and 256K. For 
Agenda accessory users this should be adequate. In general, it is best 
to use the least amount of memory possible. (Use only if you select 
Yes for Swap Y/N.) The default is 128K. 
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Using the Items Accessory 


The Items accessory lets you record your thoughts while you are 
using another application. You transfer the information that you 
enter in the Items accessory to a structured file; you can then import 
the structured file into an Agenda file at a later time. You can do this 
using the File Transfer Import command or the Auto-import file set¬ 
ting under the File Properties command. 

To bring up the Items accessory: 

• Press ALT-SHIFT-I. 

The Items accessory displays on top of the application that you are 
currently using. 

Entering Items You can enter up to 10 items, each in a separate page of the Items 
accessory. Each page represents one item; it can contain up to 350 
characters, the maximum length of an item in Agenda. The items are 
numbered sequentially from 1 to 10. 

You can see the number of the item you are working with in the 
upper right comer of the Items accessory screen. To advance from 
one item to the next, press PGDN. To go to the previous item, press 


Assigning Items 
to Categories 


Within the Items accessory, you can specify the category to which 
you want to assign all the items you enter. If you specify a new 
category, this category is created in the Agenda file. When you 
import the items in the Items accessory into Agenda, they will all be 
assigned to the category that you specify. (They will also be assigned 
to the category to which you import them.) 

Note When specifying a category, you must specify the category 


or the assignment may not be made. (For more information 
about text matching, see Chapter 19.) 


1. In the Items accessory, press Flo (menu) and select Category. 

2. Enter the name of the new or existing category in Agenda to 
which you want to assign the items and press ENTER. 


I 
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When you import these items into Agenda, they will be assigned to 
the category that you specify. 

Note If you do not specify a category within the Items accessory 

and you set Agenda to import a structured file automatically, 
Agenda assigns these items to the category MAIN in the 
Agenda file. (See "Importing Information into Agenda" later 
in this appendix.) 

Attaching External You can specify a text file as an external note file for an item that you 

Note Files have typed in the Items accessory. When you import this item into 

an Agenda file, this attachment is also transferred. 

To specify a text file as an external note file: 

1. In the Items accessory, press no (MENU) and select Note. 

2. Type the complete path and file name of the text file you want to 
attach as a note file and press ENTER. 

Be sure that this file exists or that you create it later. The Items 
accessory does not check to see if this is a valid file. 

Note An item can be attached to only one external note file at a 

time. Repeating the above procedure and entering a different 
file name attaches the new file only. 

You can detach a note file from an item you have typed into the Items 
accessory. This procedure clears the attachment of file note file, but 
does not delete the note file from your disk. 

To detach a note file: 

1. In the Items accessory, press no (MENU) and select Note. 

The Items accessory displays the name of the note file. 

2. Press CTRL-ENTER to clear the file name and press ENTER. 

Agenda detaches the note file from the item in the Items accessory. 


Detaching 
Note Files 



Deleting Items 


Printing Items 


Transferring 
Information to a 
Structured File 


You can delete items that you typed in the Items accessory if you no 
longer want to transfer them to Agenda. 

To delete items from the Items accessory: 

1. In the Items accessory, press Flo (MENU) and select Delete. 

2. Specify whether to delete All items or only the Current item. 
Agenda deletes the item(s) you specify. 

You can print some or all of your items directly from the Items 
accessory. 

To print items in the Items accessory: 

1. In the Items accessory, press PIO (MENU) and select Print. 

2. Select whether to print All items or only the Current item and 

Agenda prints the item(s) you specify. 

You must transfer the items that you enter in the Items accessory to a 
structured file before you can import them into Agenda. If you have 
attached any external note files to items in the Items accessory, this 
procedure also transfers these attachments. 

To transfer items in the Items accessory to a structured file: 

1. In the Items accessory, press fio (MENU) and select Transfer. 

2. Specify whether to transfer All items or only the Current item. 

3. Specify the name of the structured file in which to transfer the 

The default file name is TRANSEER.STF. If you have already 
transferred items to a structured file. Agenda displays the last file 
name you used. 

4. Do one of the following: 

• Press ENTER to accept the displayed file name 
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The Items accessory automatically adds the extension .STF to the 
structured file that you specify. This file will be saved in your current 
directory if no other path name is specified. 

You can now import this structured file into Agenda at any time. 

You can also use the accelerator key ALT-T to transfer all items to a 
specified structured file, append to the file (if necessary), and delete 
all of the items currently in the Items accessory. Just press ALT-T, type 
a file name, and press enter. 


Putting the Items You must put the Items accessory away before you can import items 

Accessory Away into Agenda. 

• In the Items accessory, press Flo (MENU) and select Quit. 

The Agenda accessory automatically saves all items when you put 
the accessory away. 


Importing You can import into Agenda any items that you entered in the Items 

Information into accessory. 

Agenda 


To import information into Agenda from the structured file created in 
the Items accessory: 

1. Start Agenda and open the file to which you want to import the 


2. In Agenda, press Flo (MENU) and select File Transfer Import. 
Agenda displays the Import Structured File box. 

3. Highlight Import from file and type the name of the structured 
file that you created in 'Transferring Information to a Structured 
File" earlier in this appendix. Include a path if necessary. Then 

Agenda displays the Assign to category setting. 

4. Highlight Assign to category and specify the category to which 
you want the imported items assigned. 

5. Press ENTER. 

Agenda imports the item(s) from the Items accessory to the current 
Agenda file and assigns them to the category that you specify. 
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Automatically importing structured files 

You can also set Agenda to import a structured file each time that 
you open a particular Agenda file. This lets you automatically bring 
in any information you have entered in the Items accessory. To do 
this, enter the name of the structured file containing the items from 
the Items accessory in the Auto-import file setting under the File 
Properties command. 


Note If you set Agenda to import a structured file automatically 
and you do not specify a category within the Items accessory 
to which to assign items you enter. Agenda assigns all these 
items to the category MAIN in the Agenda file. (See "Assign¬ 
ing Items to Categories" earlier in this appendix.) 


ctured files, see Chapters 23 


Using the Clipboard 


The Clipboard lets you transfer text from one application to another. 
For example, you can capture text from a word processing applica¬ 
tion and paste it into an Agenda item. 

Note This section describes some of the commands you can use in 
the Clipboard. For more information about the Clipboard, see 
your Lotus Metro documentation. 


To transfer data from another application to the Clipboard, you bring 
up the Clipboard while you are running the other application. 

To bring up the Clipboard: 

• Press SHIFT-AI.T-D. 


Copying Text 
Clipboard 


You can copy text from the application that you are working in to the 
Clipboard: 


To copy text to the Clipboard: 

1. In the Clipboard, press Flo (menu) and select Copy. 

The Clipboard displays a menu that lets you specify the amount 
of text that you want to copy. 



sing the Agenda Accessories 


2. Select a choice: 


Choice Result 

WholeScreen Copies all text from the current screen to the Clipboard 
Text Copies lines of text without trailing white space 

Rectangle Copies a block of text _ 


If you select Whole Screen, the Clipboard copies all the text on the 

If you select Text or Rectangle, you need to specify the area of the 
screen you want to capture. See the following section "Copying Text 
or a Rectangle to the Clipboard." 


Copying Text or If you select Text or Rectangle when you are copying text from 
a Rectangle to another application to the Clipboard, you must specify the region of 

the Clipboard text that you want to copy. 

To copy text or a rectangle to the Clipboard: 

1. After selecting WholeScreen or Rectangle in the Clipboard, use 
the arrow keys to put the cursor on the first character to be 

2. Press F7 to anchor the cursor. 

3. Use the arrow keys to highlight the region of text that you want 
to copy. 

The Clipboard displays the copied text. 


Formatting Before you paste the contents of the Clipboard into Agenda, you may 

Text in the want to format it. 

Clipboard 

To format text in the Clipboard: 

1. In tiie Clipboard, press Fio (MENU) and select Format. 

The Clipboard displays a menu that lets you specify how to for¬ 
mat the text in the Clipboard. 
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Normal (default) Formats the text on the Clipboard to be incorporated as a 
note. This choice preserves the format (including car¬ 
riage returns) of your original text 

Spreadsheet Formats the text to be pasted into a spreadsheet (not 

applicable for Agenda) 

WordProcessor Formats the text on the Clipboaid to be incorporated as 
an item or note. This choice does not preserve any 
_carriage returns in your original text_ 


Putting the 
Clipboard 
Away 


When you paste the contents of the Clipboard into Agenda, it will be 
formatted according to the choice you specify. 


When you have copied and formatted the text you want, put the 
Clipboard away. The contents of the Clipboard are automatically 
saved so that you can paste them into Agenda at a later time. 

To put the Clipboard away and save the current contents: 

• Press Flo (MENU) and select Quit. 

Caution If you unload Metro, the contents of the Clipboard will be 
lost. 


Pasting the Once you have copied text to the Clipboard, you can paste it into 

Contents of the Agenda 7 v 

Clipboard into 

Agenda 


Note Before you can paste text from the Clipboard into Agenda, 
you must first quit from the other application that you're in 
before you start Agenda. 

To paste the contents of the Clipboard into Agenda: 

1. Start Agenda and open the file in which you want to paste the 
contents of the Clipboard. 

2. Place the highlight where you want to begin the text (item or 
note) that you copied to the Clipboard. 
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3. Press ALT-SHIFT-ENTER. 

The contents of the Clipboard is placed in Agenda where you specify. 


Using the Kaleidoscope 


The Kaleidoscope lets you set the colors for the Items accessory, the 
Clipboard, and the Kaleidoscope itself. You can change the colors of 
the text, highlights, and borders of these accessories. You can set the 
colors for each accessory separately. 

To bring up the Kaleidoscope: 

• Press ALT-SHIFT-K. 


Changing Colors Follow the procedure below to change the colors of the Items 

Accessory, the Clipboard, and the Kaleidoscope. 

To change the colors of the Agenda accessories: 

1. In the Kaleidoscope, press Fio (MENU) and select Get. 

The Kaleidoscope asks you to enter the file name of the accessory 
whose colors you want to change. Use the following table to 
determine the file name for the accessory that you are working 


2. Type the appropriate file name and press ENTER. 

The colors in the kaleidoscope change to reflect the current colors 
of the accessory that you selected. 

3. Use the arrow keys to move the highlight to the color setting you 
want to change; press GREY + and GREY - to scroll through the 
available colors. (The colors change as you scroll through the 
choices, so that you may preview your selections.) 
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4. After you select the colors you want to use, press Flo (MENU) and 
select Save. 

5. Type the file name of the accessory for which you want to use 
these colors and press enter. 

You can use these same colors for one or more accessories. To do so, 
repeat steps 4 and 5 for each accessory. 

To return to the default colors of the Agenda accessories press 
Fio (MENU) and select Reset. The default colors are: 

• Yellow text on a black background 

• White highlighted text on a blue background 

• Yellow border 


Plifting the To put the Kaleidoscope away: 

Away 


• Press Fio (MENU) and select Quit. 


I 
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Compose Sequences 


A compose sequence is a series of keystrokes you use to enter a char¬ 
acter that is not on your keyboard. You enter these characters by 
pressing ALT-F1 (COMPOSE) and the appropriate two-character 
compose sequence. For example, to enter the character £ (the British 
pound symbol), press ALT-F1 (COMPOSE) and then type L-. 


Printer and Monitor Output 


Some printers and monitors cannot print or display all of the compose char¬ 
acters. In these cases. Agenda prints or displays a "fallback" character 
or characters in its place. For example, if you enter the compose 
character for A, but your printer is unable to print that character. 
Agenda prints A in its place. You may need to test the compose char¬ 
acters to determine which ones print with your printer. Your screen 
display and printed output may look different for some compose 
characters because of your monitor and printer capabilities. 


Compose Sequences 


The following table is a complete list of compose sequences. The 
symbol (or description) in the Result column represents the character 
that appears if your computer is using Code Page 850. For some 
compose sequences, a different character appears if your computer is 
using another code page. 

If your computer uses Code Page 437, you can set Agenda to translate 
from Code Page 850 to Code Page 437. This will ensure correct 
display of all characters common to both Code Pages, but there are 



Sequences 


still some characters that cannot be correctly displayed in this config¬ 
uration. (For more information see Appendix H and your operating 
system manual.) 

Press alt-fi (COMPOSE) followed by: 




Second key Result 


P 1 

P 1 

spacebar " (uppercase umlaut) 


- (syllable hyphen) 





Compose Sequences 







Compose Sequences 









Compose Sequences 



The characters shown in the following table are not available on some 
keyboards. In Agenda, you can enter these keys by holding down the 
ALT key and pressing the appropriate number key (from the top row 
of the typewriter keyboard, not the numeric keypad). For example, to 
enter a left brace ({), hold down alt and then press 1. 


I 
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Memory Management 


Many factors affect the amount of memory available for Agenda 2.0. 
Among them are the size of the operating system and other programs 
you have in memory, the size of the drivers you select during instal¬ 
lation, and the amount of information you enter in an Agenda file. 


In this Appendix 

This appendix describes 

• Memory use in Agenda 

• Interaction between Agenda and other programs that may reside 

• Procedures for changing the amount of memory Agenda uses 
when printing 


Terms You Need to Know 


You need to know some terms before you use this appendix: 

• Random access memory (RAM) is a computer's temporary stor¬ 
age, measured in kilobytes (K). The computer checks RAM each 

working and available. RAM does not include the permanent 
memory available on the hard disk or on floppy disks (such as a 
20 MB hard drive or 1.2 MB disk.) 

system makes available to application programs such as Agenda. 



E-2 Memory Management 


Expanded memory is memory in addition to the 640K conven¬ 
tional memory limit that meets the Lotus/Intel®/Microso£t® 
Expanded Memory Specification (EMS). Expanded memory 
works in conjunction with conventional memory using a tech¬ 
nique called page swapping. Expanded memory is divided into 
blocks of 16K called pages. To use this memory. Agenda copies 
(or swaps) the contents of a page of expanded memory into con¬ 
ventional memory. The standard amount used for page swapping 
is 64K (equal to 4 pages). 

Extended memory is memory in addition to the 640K conven¬ 
tional memory limit that some applications can use directly with¬ 
out swapping. This memory is available on computers that use 
Intel 80286 microprocessors and above. 


Note Agenda does not use extended memory. 

• Virtual memory is any available memory in your computer that is 
used as RAM. This includes conventional memory, expanded 
memory, and permanent memory available on the hard disk. 
Agenda uses virtual memory when printing and when the file 
requires more than the available conventional and expanded 
memory. 


Agenda and Expanded Memory 


Agenda requires a minimum of 435K of conventional memory to run 
if you have no expanded memory. With expanded memory, the 
minimum requirement of conventional memory is 395K. If you have 
enough memory to run Agenda, you can retrieve any Agenda file, no 
matter how large it is. 

Note If you have a monitor that displays 43 or 50 lines at a time, 
you can subtract 5K from the above minimum requirements. 

To increase performance when working with a large Agenda file, you 
should make available as much memory as possible. For example, if 
you have other software running in the background while using 
Agenda, such as device drivers, or a terminate-and-stay-resident 
program (TSR), you may want to remove these other programs to 
increase Agenda's performance. 



Memory Manage 


If you have more than 640K of memory in your computer. Agenda 
automatically uses all the available expanded memory (up to 8MB). 
However, if you do not see an increase in performance while using 
Agenda, your computer's extra memory may be configured as 
extended memory, not expanded memory. Agenda does not recognize 
extended memory. 

To see if your computer's extra memory is configured as extended 
memory, check Agenda's expanded memory setting, described in 
"Checking Memory Settings." If the choice for expanded memory is 
0, the extra memory is configured as extended and should be 
changed to expanded memory. 

Some memory programs, such as 386 MAX ™ or the Compaq Expanded 
Memory Manager (CEMM), configure extra memory (above 640K) 
either way. See the manuals for the memory management program 
you have for procedures to reconfigure additional memory as 
expanded. 


Agenda and TSR Programs 


If you tiy to start Agenda and receive an error message about insuffi- 
cient memory or that Agenda is too large to fit in memory, it means 
that your computer does not have enough conventional memory 
available to run Agenda. If you have 640K of conventional memory 
and you see either of these messages, you are probably running a TSR 
program, such as Lotus Express® or a network software program. 
When you run a TSR, a part of the program remains in RAM even 
when you are not using it. When you press the key combination that 
activates the TSR, you are actually running the part of the program 
that remains in memory. That part of the program in turn starts the 
rest of the program. 


The only drawback to TSRs is that the piece of the program that 
remains active in your computer uses conventional memory. If 
another TSR program is using conventional memory and prevents 
you from using Agenda, remove the TSR before running Agenda. 


I 
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Virtual Memory and Printing 


Agenda uses your system's available memory and storage devices as 
virtual memory so that the size of the document you print is not lim¬ 
ited by the amount of RAM available. The default amount of memory 
Agenda uses as virtual memory is enough for printing Agenda files 
up to about 50 pages. When printing a file. Agenda attempts to 
obtain virtual memory from the following sources, in this order: 

• Expanded memory 

• Disk space in the Agenda program directory 

• Disk space in the root directory 

When printing or previewing an Agenda file, you may receive a mes¬ 
sage that you are out of virtual memory. If this happens, check the 
memory settings. (See the following section.) The maximum value 
for both expanded memory and memory for printing is 8192K (8MB). 
By default, expanded memory is set to 8192K and memory for print¬ 
ing is set to 1024K (1MB). 

To avoid a message that says you are out of virtual memory, you can 
increase the amount of memory Agenda uses for printing, described 
in "Increasing Memory for Printing." 


Checking Memory Settings 

To check Agenda’s memory settings: 

1. Press Flo (MENU) and select Utilities Customize. 

Agenda displays the Utilities Customize box. 

2. Highlight Memory Usage and press space bar. 

Agenda displays the Memory Usage box. The settings are 
described in the following section. 

3. Complete the box and press enter. 




Appendix F 

File Reservations and Networks 


With Agenda 2.0, you can share Agenda files with other people or 
print an Agenda file to a network printer. Agenda also has controls, 
called file reservations, that make sure people who share files do not 
write over each other's work. 

If you have questions about networking procedures or run into prob¬ 
lems while using Agenda files on a network, see your network 
administrator. The network administrator is the person responsible 
for setting up the network server and for maintaining the network 
for your company or work group. If your network administrator 
cannot solve the problem, he or she should call Lotus Product Sup- 

It is important to channel your questions through your network 
administrator, who has information about the network that Lotus 
Product Support needs in order to help. 

Caution For the Agenda file reservation system to work properly, it 
is very important that you use Agenda 2.0, which is 
designed to support file sharing. Sharing data files with 
another release of Agenda can lead to loss of information. 


In this Appendix 

This appendix describes how to 

• Share files on a network 

• Prepare for printing on a network printer 
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Sharing Files on a Network 


To work with shared Agenda files on a Local Area Network (LAN), 
you must connect your personal computer to the LAN and specify 
the path to the shared files on the network server. The command you 
use to connect your computer to the network is specific to your net¬ 
work software. Ask your network administrator for the proper com- 

To retrieve a file from a network server into Agenda, you must spec¬ 
ify its complete path when you use the File Retrieve command. The 
path must include the following information: 

• The logical drive letter of the server's data directory 

• The appropriate subdirectories 

• The name of the shared file 

For example, to retrieve the Planner file from a network drive X: and 
a network directory called AGDATA, type: 
x:\agdata\planner 

Note The path listed above is an example only. Your network may 
use different letters and/or subdirectory names. Ask your 
network administrator for the correct path to the files on your 


About File As soon as you make a file available on a network, it means that more 

Reservations than one person can look at, change, and update the file at one time. 

Without controls, one person can inadvertently write over another 
person's changes. Agenda provides controls, called file reservations, 
to solve this problem. 

A file reservation ensures that no more than one person at a time can 
save changes to a file, although several people can read the file simul¬ 
taneously. The only person who can save changes to a file is the one 
who has its reservation. 

By default, if you are the first person to retrieve an Agenda file from 
the network, you have its reservation. If other people retrieve that 
same file, they have read-only access, which means they can look at 
the file but can't save any changes they make to the original file 
name. Agenda displays the READ ONLY indicator next to the file 
name at the top of the screen as an indicator that the retrieved file is 
already reserved. 
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If you make changes to a read-only file and then quit Agenda (which 
automatically attempts to save the file). Agenda displays the Read 
Only File box. (Figure F-l). 



• Try to get the reservation for the file 

Note To see the options available in the Read Only File box, press 


same time you were making changes, you no longer have the most 
recent version of the file and you can't get its reservation, even if the 
person saves the file and releases the reservation. 

To save the changes you make to a read-only file, you must save the 
information to another file name, retrieve the original file to get its 
reservation, and then manually merge your changes with the con¬ 
tents of the original file. 

Most of the time, the reservation system is appropriate for your neeu* 
and should not need to be changed. Those people who have special 
requirements or who wish to change reservations should read the 
following sections. 

Note The DOS Attrib command or any network command that 

assigns read-only status to a file or directory overrides Agen¬ 
da's reservation status. For example, you cannot get the res¬ 
ervation for a file that was assigned read-only status by the 
DOS Attrib command, even if no other person has the 
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Setting the Default File Reservation 


The Get reservation setting determines how you get the file's reser- 

1. Press Flo (MENU) and select File Properties. 

2. Highlight Get reservation and press F3 (CHOICES). 

Choice Result 

Automatically (default) The first person to read a file into memory gets the 
file reservation automatically. 

Manually No one automatically gets the reservation. 

Agenda asks whether you want the reservation 
when you retrieve the file. You can also use File 
Maintenance Reservation after you retrieve the 
_ file to try to get the reservation. 

3. Move the highlight to select your choice and press ENTER. 
Agenda sets the default file reservation. 


Guidelines for Choosing the Default File Reservation 


For some Agenda files or situations, you may want to change the Get 
reservation setting. To decide on a reservation choice for a particular 
file or group of files, consider the work group that will share the 


If most of the people in the work group are likely to save changes 
to the file each time they retrieve it, choose Automatically That 
way, the first person to retrieve the file, who is likely to need the 
reservation, gets it. 

If most members of the work group use the file for reference only, 
choose Manually. That way, only the person who needs the reser¬ 
vation gets it; someone who does not need the reservation doesn't 
inadvertently prevent others from getting it. 
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Releasing and Getting File Reservations 


When you save a file to a new file name or quit Agenda, you auto¬ 
matically release the reservation you have for the file. However, if 
you have the reservation and you haven't made changes to the file, 
you may want to release it so that another person can get the file and 
save their changes. 

You need to get a reservation for a file if you have read-only status 
for the file and you want to make changes to the file. In this case, you 
should get the reservation for the file before you make any changes. 


Releasing a File To release the reservation for the current file: 

Reservation 

1. Press Flo (MENU) and select File Maintenance Reservation. 
Agenda asks you whether you want to release the reservation for 
the file. 

2. Press enter to release the reservation. 

After you release the reservation for a file, another person can 
retrieve the file and save changes to it. 

Note If you have the reservation for a file and you save the file to a 
new file name, you automatically release the file reservation 
for the original file name. 


Getting a File To get the reservation for a file: 

Reservation 

1. Press Fio (MENU) and select File Maintenance Reservation. 
Agenda asks you whether you want to get the reservation for the 

2. Press enter to get the reservation. 

If the file reservation is available. Agenda removes the READ ONLY 
indicator and you can save any changes you make to the original file 

If the file reservation is not available. Agenda displays an error mes¬ 
sage and leaves the file with a read-only status. 
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Guidelines for Sharing Files 


Consider the following guidelines as you use files on the network: 

• For some network configurations, you may need to explicitly con¬ 
trol which directories Agenda uses when creating and looking for 
files. Use the DOS Set command and the AG_ENV or AG_TMP 
environment variables to identify these directory locations. For 
more information, see Chapter 1 in Setting Up Agenda. 

• If you retrieve a file without having the reservation for the file and 
save changes to the file with a different file name, do not copy the 
new file over the original file when the original becomes available. 
If you do, you may write over another person's work. 

• If you retrieve a file with Get reservation set to Automatically 
and you do not intend to save changes to the file, remember to 
release the reservation so another person can get it. 

• If you try to retrieve a file while another person is retrieving it, or 
if you try to retrieve a file while another person is saving it, 
Agenda displays the WAIT indicator until the first person com¬ 
pletes the process of reading or saving the file. You can press 
ctrl-break to return to the point prior to which you tried to read 
or save the file. 

• If you have external note or macro files on a network that are 
attached to an Agenda file, you can change the contents of the 
external files if you are the first person to edit them. If you try to 
edit a file that is already in use by another person, however. 
Agenda notifies you that the file is unavailable. You must wait 
until the first person is finished before you can make changes. 
When the file is available and you start to edit it. Agenda notifies 
you that the file has changed and your screen will be updated 
with the new contents. Press any key to remove this message and 
Agenda displays the first person's changes on your screen. You 
can then make your changes and save the file. 
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Printing over the Network 


To print an Agenda file to a network printer, you must know the 
printer port name and the kind of printer (for example, Apple Laser¬ 
Writer, HP Laserjet, Epson FX85®) that is connected to the network. 

To connect your computer to a network printer and port, use network 
software commands. These commands may execute automatically 
when you log into the network. If an Agenda file does not print to a 
network printer, check with your network administrator to make sure 
your computer is configured to use the network printer. 

After you have connected your computer to the network printer, use 
the Print Setup command to select the network printer type and 
printer port to use. For information on using the Print commands, 
see Chapter 17. 

Note Your network must contain print spooling software; Agenda 
does not manage the print spooling. Also, depending on your 
network and print spooler configuration, you may need to 
exit from Agenda before printing begins. 
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Application Protection 


This appendix introduces Agenda application protection. It is 
intended for application developers and describes some of the fea¬ 
tures that are available to develop Agenda applications for users. 
The features described in this appendix let you protect the 
applications that you develop, before you distribute them to users. 
Agenda provides a variety of features that let application developers 
build Agenda applications. Be sure to read Working with Macros for 
detailed information about the macro commands that you can use to 
build these applications. 

Before proceeding, you should have a good working knowledge of 
Agenda and its features (particularly macros). 

Note In this appendix, the term "you" refers to the person who 

develops Agenda applications. The term "user" refers to the 
person who uses these applications. 


In this Appendix 


This appendix describes 

• How to set protection to prevent users from changing all catego¬ 
ries and/or views in a file 

• How to set protection to prevent users from changing individual 
categories, views, and/or macros in a file 

• How to seal and unseal a file to make permanent the protection 
settings you specify 



What is Application Protection? 


Asan application developer, you might want to limit the types of 

to prevent users from discarding categories in an application that you 
develop. Agenda lets you set protection for a file to prevent users 

other types of dianges to a file. ^ ® 

Agenda lets you protect files on a category, view, and macro level. 
You can set protection for all the categories and/or views in a file 
(global protection) or for a specific category, view, and/or macro 
(local protection). 

Once you specify the type of protection that you want, you can seal 
the file. Sealing a file makes permanent the protection settings that 
you specify for the current file. This prevents users from making 
changes to the parts of Agenda that you have protected. Changes to 
a sealed file can only be made once a special seal/unseal password is 
entered for that file. 

Protecting the categories, views, and/or macros in a file lets you pro¬ 
tect the structure of that file. Sealing the file ensures this structure. 

Of course, you can always specify protection settings without sealing 
the file. If you don't seal a file, protection is still set, but users are 
also free to change the protection settings or turn them off com¬ 
pletely. 

Note Protection does not prevent users from adding, editing, or 
deleting items or notes in a file. In addition, protection does 
not protect assignments of items to categories. 

Bypassing One important feature that Agenda offers is the ability to provide 

Application macros that bypass all protection (both global and local) for a file 

Protection This means that even after a file is sealed, these macros can make 

changes to a file that the user would be prevented from making 
(given the protection set for that file). For more information, see 
■■Sealing/Unsealing Protection Settings" later in this chapter. 

Note If you plan to provide macros that bypass protection for a file, 
you must do so before the file is sealed. 
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Global and Local The concept of global and local settings applies to many areas of 
Protection Agenda. For example, you specify global default date formats and 

text matching criteria that apply to a file. 

You can also establish global default protection settings for the cate¬ 
gories and views in a file. Once you specify these global defaults. 
Agenda applies these protection settings to all the categories and 
views in that file. 

In addition, for any given category or view you can specify a different 
type of protection. This local protection setting overrides the default 
global protection for the file. 

For example, you might want to protect all the categories in an appli¬ 
cation that you develop, but allow users to make changes to specific 
categories in that file. In this case, you'd set global category 
protection (to protect all categories in that file) but override protec¬ 
tion for specific categories (by setting the local protection for those 
categories to No). 

For example, you might have a macro that prompts users to add a 
category (such as a person's name) and then turns local protection off 

Turning protection off for the categories that users add lets users 
work with these categories (change their properties, delete them, and 
so forth), while maintaining protection for the rest of the categories in 

You cannot establish global protection for macros. Macro protection 


What Can You Protect? 


This section describes the types of protection that you can set for the 
categories, views, and/or macros in a file. For information about 
how to set each of these types of protection, see "Setting Protection" 
later in this chapter. 



Category protection 

• Prevents users from making any changes to the properties of pro¬ 
tected categories in a file (all Category Properties settings, as well 
as those under Advanced Settings) 

Note Even if a category is protected, the user can still make or 

break assignments of items to this category. The user can also 
remove or include this category in conditions and actions for 
other (unprotected) categories. 

Category can have new children 

• Lets users add a new category as a child of a given category. (The 
global default category protection applies to any categories that 


Full view protection 

• Prevents users from making any changes to the properties of pro¬ 
tected views in a file (all View Properties, Section Properties, and 
Column Properties settings). For example, prevents users from 
changing the width and positions of columns and sections in 


• Prevents users from adding or deleting sections and/or columns 
in views in a file 

Note Protecting views ensures the structure of these views only if 
the categories in these views are also protected. For example, 
if a category used as a column head can be discarded, then a 
view cannot really be considered protected. Therefore, to 
ensure that the view is protected, make sure that alt the cate¬ 
gories in that view are protected — either by setting global 
category protection for the file or local protection for each 
category in the view. 

• Prevents users from deleting protected views 

Append only view protection 

The term existing in the following descriptions refers to the sections 
and columns that exist in views at the time that you set view protec¬ 
tion to append only. 
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• Prevents users from making any changes to the properties of pro¬ 
tected views (all View Properties, Section Properties (except for 
Columns), and Column Properties (except for Width) settings) 

• Lets users change the width and positions of new and existing 

• Prevents users from deleting existing sections and/or columns in 
protected views 

• Lets users make changes to all of the properties of sections and / or 
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Category protection 
Category not protected 


Category can have 
children 

View protection 


Category manager, beside each ca 
gory for which child categories cm 
added (if set with local protection; 
N/A N/A 

N/A N/A 


manager for mj 

Sealing/Unsealing Once you specify protection for the categories, views, and/or macros 

Protection Settings in your file, you can seal the file. Sealing a file makes permanent the 
protection settings that you specify. This prevents users from making 
changes to the parts of Agenda that you protect. Otherwise, if you do 
not seal a file, users can change the protection settings. 

You might need to make changes to a file that you sealed before you 
distribute it to users. Users might need to make changes to a sealed 
file, even though they would not typically do so. Agenda lets you (or 
users) unseal a file in order to make changes that otherwise conflict 
with the protection settings for that file. To unseal a file, you enter a 
special seal/unseal password. 

For example, suppose you develop an application for the Human 
Resources Department. In the application, employee names are cate¬ 
gories. You set global category protection for this file to prevent 
users (for example, staff in the Human Resources Department) from 
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inadvertently making changes to the categories in that file (for exam¬ 
ple, discarding employee names). You then seal the file so that users 
can't change the protection settings. 

Human Resources Department staff may need to discard the names 
of employees who leave the company. In this case, the manager can 
temporarily unseal the file and turn off global category protection (so 
that staff can discard employee names, if required). Once the work 
on this file is complete, the manager can set global category protec¬ 
tion once again, and then reseal the file so that no further changes can 
be made to categories in this file. 

Note If a file is protected, there are certain operations that can't be 
performed. Once you seal the file, this protection can't be 
changed (unless the file is unsealed). 

Instead of unsealing the file, you might want to be able to 
make changes to a file that conflict with the protection set¬ 
tings for that file. For example, you might have the global 
default set so that users can't add new child categories. 
However, you might want to let users add categories to the 
file at certain times — even though this operation conflicts 
with the category protection setting. 

You can provide a macro that performs operations that con¬ 
flict with a protection setting, as described in the above exam¬ 
ple. To do this, you must choose Yes for Macro can override 
protection in the Macros Properties settings. For more 
information, see Chapter 1 in Working with Macros. 

Sealing a File You can seal a file so that users cannot change the global and/or local 

protection settings that you set for that file. 

To seal a file: 

1. Open the file that you want to seal. 

2. In a view, press HO (MENU) and select File Properties. 

Agenda displays the File Properties box. 

3. Highlight Global protection and press SPACE BAR. 

Agenda displays the Global Protection Settings box. 

4. Highlight Seal the file and press SPACE BAR. 

Agenda prompts you to enter a password. 







5. Type a password (up to 12 characters) for this file and press 

Agenda prompts you to enter the password again. 

6. Type the password again and press ENTER three times. 

Note You should memorize this password since it is now the 

unseal password that you need to enter to unseal the file later. 
Agenda seals the current file. 

Once you seal a file, users cannot change any of the protection set¬ 
tings identified in the table in "Setting Protection" earlier in this chap- 

In addition, when a file is sealed, users cannot switch between dis¬ 
playing and not displaying hidden macros in the macro manager. 


Unsealing a File You can unseal a file so that you (or users) can change the global 
and/or local protection settings that you have set for the file. 

To unseal a file, you enter the password used to seal the file. Once 
you unseal the file, the password no longer applies. You must 
specify a password again to reseal the file. 

1. Open the sealed file that you want to unseal. 

2. Press Fio (MENU) and select File Properties. 

Agenda displays the File Properties box. 

3. Highlight Global protection and press SPACE BAR. 

Agenda displays the Global Protection Settings box. 

4. Highlight Unseal the file and press SPACE BAR. 

Agenda asks you to enter the unseal password for this file. 

5. Type the same password that you entered to seal the file; then 
press ENTER three times. 

Agenda unseals the current file. 


I 
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International Considerations 


Agenda is designed to work in most North American and European 
countries, supporting a wide variety of international 
characters and date formats. 


In this Appendix 

This chapter describes 

• How to configure Agenda's characters set for international use 

• How to produce international characters 

• How to work in Agenda within an international context 


Configuring Agenda’s Character Set 


Agenda stores information in the multilingual char 
Code Page 850), which includes characters appropi 
countries including the following: 


Austria 
Australia 
The Benelux 
Canada 
Finland 

Germany 

Italy 


Latin America 
(Spanish-speaking) 

Switzerland 
United Kingdom 
United States 
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Producing International Characters 

You can enter international characters into Agenda in several ways. 

• Various National Keyboard Programs supported by IBM 

• Compose sequences 

• The numeric keypad 

The following sections describe the various ways you can enter inter¬ 
national characters. 


Using National Agenda is compatible with the various National Keyboard Programs 

Keyboard supported by IBM. Running a keyboard program lets you use any 

Programs international characters on your keyboard, without using the com¬ 

pose sequence to produce them. (For more information, see your 
operating system manual.) 


Using Compose You use ALT-F1 (COMPOSE) to enter international characters in 
Sequences Agenda. Press alt-fi (compose) and then a sequence of two charac¬ 

ters that Agenda translates into a single international character. For 
complete information about using compose sequences, see Appendix 
D. 

Note You cannot use alt-fi (compose) in the Agenda accessories. 
You can, however, use the numeric keypad (described in the 
following section) to enter characters that are not on your key- 


Using the Numeric You can enter an international character by holding down the ALT 
Keypad key and entering the three-digit code for the character you want to 

produce, based on the code page (character set) you are using. To 
enter this code, you must use the numeric keypad, not the numbers at 
the top of your keyboard. (See Appendix D.) 


Printing Whether your system is configured for Code Page 850 or Code Page 

International 437, Agenda prints based on the Code Page 850 character set. This 

Characters means that any characters that are not in Code Page 850 print incor- 



Note You cannot print international characters directly from the 
Items accessory. To print items with these characters, you 
must first transfer them to a structured file, using the 
Transfer command in the Items accessory. You then import 
the items into Agenda and print them. 


Working in Agenda 


The following sections outline the way Agenda performs various 
operations within an international context. 


Selecting Number You can specify the characters to use as number separators in num- 
Separators bers that you enter, for example, in numeric columns in your file. By 

default. Agenda uses a period (.) to separate decimal places in 
numbers and a comma (,) to separate thousands in numbers, for 
example, 3,000.00. Many countries use a comma (,) to separate deci¬ 
mal places and a period (.) to separate thousands in numbers, for 
example, 3.000,00. 

Note You must specify different characters for the decimal place 
and thousands separators. 

To specify the decimal place and thousands separators in numbers: 

1. Press Flo (MENU) and select Utilities Customize. 

Agenda displays the Utilities Customize box. 

2. Highlight Decimal separator and select the one you want to use. 
The choices are. (Dot) (default) and, (Comma). Then press 


3. Highlight Thousands separator and select the thousands separa¬ 
tor you want to use. The choices are. (Dot),, (Comma) (default), 
and (Space). Then press enter. 

Agenda displays number separators based on the choices you spec- 



Working With Text 
Matching and 
Searching 
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By default. Agenda considers accents when matching items to catego¬ 
ries for text matching. Agenda also considers accents when you use 
ALT-F6 (SEARCH) or the Utilities Show Match command. This means 
that the word "esta" does not match the word "esta." 

However, by default, Agenda ignores suffixes when matching items 
to categories for text matching. Thus, item text such as "calls", "call¬ 
ing", or "called" matches the category Call, because "s", "ing", and "ed" 
are common suffixes in the English language. 

Since these are not necessarily the suffixes used in other languages, 
you may want to set Ignore suffixes to No for a file and/or for indi¬ 
vidual categories when using a language other than English. That 
way. Agenda always considers whole words when matching items to 
categories for text matching. 

considers accents and/or suffixes) throughout a file or for individual 
categories. 

Tip Setting Agenda to ignore accents throughout a file, however, 
can slow performance significantly. Instead, you might want to 
set Agenda to ignore accents in words when matching text for 
specific categories in your file (described at the end of this sec- 


To set Agenda to consider accents and suffixes when matching text 
throughout a file: 

1. Press Flo (menu) and select File Properties. 

Agenda displays the File Properties box. 

2. Highlight Auto-assign settings and press SPACE BAR. 

Agenda displays the Auto-Assign Global Settings box. 

3. Highlight Ignore suffixes, select No, and press ENTER. 

4. Make sure that Ignore accents is set to No. If it isn't, highlight 
Ignore accents, select No (the default), and press ENTER twice . 

Agenda considers accents and suffixes when matching text through- 

To set Agenda to consider accents and suffixes in words when match¬ 
ing text for an individual category: 

1. Highlight the category, press Fio (MENU), and select Category 
Properties. 
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Sorting 

International 

Characters 


Agenda displays the Category Properties box. 

2. Highlight Advanced settings and press SPACE BAR. 

Agenda displays the Advanced Properties box for the category 
that you highlighted in Step 1. 

3. Highlight Ignore suffixes, select No, and press enter. 

4. Make sure that Ignore accents is set to No. If it isn't, highlight 
Ignore accents, select No, and press enter twice. 

In the majority of European languages, accented letters retain their 
accents in uppercase as well as lowercase. This means that a should 
match A, but not A. In French, however, uppercase characters do not 
have accents. If you want "ecole" to match "Ecole" (as it should in 
French), then you should set Ignore accents to Yes (under Auto¬ 
assign settings) using the File Properties command. 


Agenda uses a sorting sequence that sorts characters correctly for the 
majority of European languages. It does not support the Scandina¬ 
vian sorting sequence. 

The AE diphthong (JE), O slash (0), and A ring (A) sort after the 
letter Z. Words starting with these characters sort on the second 
character in the string. This means that a sequence of words that start 
with these characters may sort unpredictably (for example, Ma, Ab, 


Using Automatic 
Completion 


Automatic completion is not accent sensitive. For example, if you 
type 4c, Agenda matches the categories ecrit and economy. 


International Dates in Agenda 


In Agenda, how you enter dates and times (how Agenda interprets 
them) and how you display dates and times do not have to be the 
same. For example, you can set Agenda to interpret dates in month- 
day-year order. For example, if you enter II /12/90, Agenda inter¬ 
prets this as November 12,1990. You can then display dates in 
day-month-year order. In this case. Agenda displays November 12, 
1990 as 12/11/90. 




You can also choose to enter dates and times with different separa¬ 
tors. For example, you can enter dates using a period (for example, 
11.12.90) and then choose to display dates using a hyphen (-) as the 
separator (for example, 11-12-90). 

You complete the Input format settings in the File Properties, Global 
Date Settings box to control how Agenda interprets dates. You com¬ 
plete the Display format settings, also in the File Properties, Global 
Date Settings box to control how Agenda displays dates. For 
procedures for setting how Agenda interprets and displays dates, see 
Chapters 6 and 7. 


Interpreting Dates 


You should set Agenda to interpret dates based on how you enter 
dates. For example, if you enter the item "Meet Isabel on 11/6/90", 
where "11/6/90" means June 11,1990, you should set Agenda to 
interpret dates in a day-month-year order. 

Use the File Properties command. Press space bar on Global date 
settings and on Input format. Then complete the Number order 

Tip If the way you want Agenda to interpret dates generally differs 
from the Agenda default, you can specify how you want 
Agenda to interpret dates and then complete the Update 
defaults setting under the File Properties command. With this 
procedure, your choice for interpreting dates, as well as any 
other file properties that you select, become the new defaults 
for all new Agenda files that you create. 

You may receive an Agenda file that already contains information 
and is set to interpret dates differently than how you interpret dates. 
For example, if you receive a file with the item "Meet Isabel on 
11/6/90" and the file is set to interpret dates in a month-day-year 
order, then "11/6/90" means November 6,1990. 

If you change the way Agenda interprets dates for this file (for exam¬ 
ple, to a day-month-year order) Agenda interprets all items with 
dates that you enter or edit from now on based on the new choice that 
you specify. So, if you enter the item "Call William on 12/10/90", 
Agenda interprets the date in this item to mean "October 12,1990”. 
Items already in the file are not affected unless you press ALT-X, use 
the Utilities Execute command, or edit the item. 



Note If you change the way Agenda interprets dates and then press 
ALT-x, Agenda reinterprets the dates in items already in the 
file. This can produce incorrect results. 

For example, you may have a file that was set to interpret 
dates in month-day-year order and it contained the item 
"Arrange meeting on 11/10/90”. (In this case, ”11/10/90" was 
supposed to mean November 10,1990.) If you change this file 
to interpret dates in day-month-year order and press ALT-X, 
Agenda reinterprets the date in this item to mean "October 11, 
1990", which is not the date originally entered in this item. 


Displaying Dates 


You can set Agenda to display dates in date columns based on your 
preferences. For example, if you want to display dates in the 
DDMMYY format, you can select this choice using the File Properties 
command. 

Press SPACE BAR on Global date settings and on Display format. 

You can also choose the separator that you want to display in dates, 
such as a period (.) or hyphen (-). 

Note Changing how Agenda displays dates in a file only affects the 
display of dates in date columns, not in item or note text. 

If you change how Agenda displays dates. Agenda displays both 
existing dates in the file and any dates that you enter in this file in the 
format you specify. Dates are still interpreted based on the Input 
format settings specified for the current file. 

Changing the display format using the File Properties command 
does not affect the display of dates in columns for which local display 
formats are set. Dates in these columns continue to display in the 
display format set for each of these columns. For information about 
setting local display formats for date columns, see Chapter 7. 

Tip If the way you want Agenda to display dates differs from the 
Agenda default, you can specify how you want Agenda to dis¬ 
play dates and then use the Update defaults setting under the 
File Properties command. With this procedure, the choice that 
you select for displaying dates, as well as any other file proper¬ 
ties that you select, become the new defaults for all new 
Agenda files that you create. 
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Specifying Dates 


Agenda converts dates expressed in English (for example, "next 
Monday") to calendar dates (for example, "November 5,1990"). This 
does not work with any language other than English. If your text is 
not in English, then you must enter dates in calendar format (for 
example, "January 21" or ”11/8"). 

Tip You might want to combine text conditions and actions to have 
Agenda interpret dates in your own language. For example, 
you can create a category called Manana with a action to set 
the When date to "tomorrow". Then, if an item contains the 
word "manana," Agenda assigns it to this category and gives it 
a When date of tomorrow. 


Dates in the Items Accessory 


You do not need to set the Items accessory for your local date format. 
If you are running a local language version of your operating system, 
or if you have added the COUNTRY command to your CONFIG.SYS 
file, the Items accessory stores dates so that they are interpreted 
according to your country's date format when you import your items 
into Agenda. (See your operating system manual for details about 
the COUNTRY command.) 


I 



Appendix I 

Recovering a Damaged File 


If an Agenda file becomes damaged, you cannot use it or save infor¬ 
mation to it. A file can become damaged if another program changes 
the file accidentally or if the computer experiences a power loss or 
surge that destroys information on the hard disk or in memory. 

To recover the information in a damaged file, you use the file recov¬ 
ery utility called DB2STF. This program exports the information 
from the damaged file to a structured file (.STF), preserving as much 
information as possible. After using DB2STF, you create a new 
Agenda file, import the information from the .STF file to it, and then 
re-create the structure of the original file. 

DB2STF recovers Agenda 1.0/1.01 files (DOS and OS/2 versions) as 
well as Agenda 2.0 files. 


In this Appendix 


This appendix describes how to: 

• Run DB2STF to export information from a damaged file to a struc¬ 
tured file 

• Import damaged information from the .STF file to a new Agenda 
file 

• Re-create the views, macros, and category hierarchy of the original 
file in the new file 



Damaged Files and Agenda 2.0 


File damage is rare in Agenda 2.0. If a file becomes damaged, how¬ 
ever, Agenda 2.0 displays the DMGD! indicator in the upper right 
comer of the screen and the Damaged File box (Figure 1-1). 



Figure 1-1 The Damaged File box 


The Damaged File box gives you two choices. You can: 

• Save the damaged file to a new file 

• Quit Agenda without saving the file. 

If you save to a new file, the new file is damaged, but it contains the 
changes you made since you last saved the file. If you quit without 
saving the file, the original file may not be damaged, but you will lose 
the work you did since you last saved it. 

If you save the damaged information to a new file. Agenda gives the 
new file the same name as the original, but appends an at sign (@) to 
the file name. For example, if the original file name is MYINFO.AG, 
Agenda saves the information to the new file name MYINFO@.AG. 
After you save the damaged information to a new file. Agenda dis¬ 
plays the Select File box. Choose a different file to retrieve or press 
ESC to quit Agenda and return to the operating system. 




Recovering a Damaged File 


What DB2STF Recovers 


DB2STF recovers the following parts of an Agenda file: 

• Categories and their properties (including conditions and actions) 

• Explicit assignments 

• Macros 


• Print settings 

• Attachments to external note, macro, and named print set files 
DB2STF does not recover: 

• Conditional assignments 

• Filters 

• Global settings 

• Views 

DB2STF includes an option to convert conditional assignments to 
explicit assignments when creating the structured file. However, you 
must reconstruct any other lost parts after running DB2STF. 


Using DB2STF 


DB2STF works in DOS only. If you are an OS/2 Agenda 1.0 user, you 
must run DB2STF from the DOS Compatibility box or the DOS 
prompt in the Program Selector. 

DB2STF has three choices: 

• Create a structured file with the same name as the original 

• Create a structured file with a name different from the original 
(optional) 

• Create a structured file that changes conditional assignments to 
explicit assignments (optional). 




Recovering a Damaged File 


You might want to use a different name for the structured file to 
further distinguish it from the damaged Agenda file. You also might 
want to change conditional assignments to explicit ones since 
DB2STF can recover only explicit assignments. 

To run DB2STF: 

1. At the DOS prompt, enter: 

db2stf filename l/o=newfile] [/c] 

• filename is the name of the damaged file, without the .AG 


• brackets ([ ]) enclose the optional choices for DB2STF 

• / o= tells DB2STF the output file name for the structured file 

• new file is the new name for the structured file, without the 
•STF extension 

• / c tells DB2STF to change conditional assignments to explicit 
assignments 

For example, if you type: 

db2stf myinfo@ /o=mytemp /c 

DB2STF saves the information in MYINFO@.AG to a structured 
file called MYTEMP.STF and changes conditional assignments to 


Note DB2STF assumes you want to recover an Agenda 2.0 file. If 
you are recovering an Agenda 1.0/1.01 file, you must specify 
the .AGA extension with the file name. 

If the damaged .AG file has a password, DB2STF asks you to 

2. Type the password (if needed) and press enter. 

If you already have a structured file with the same name. Agenda 
asks whether you want to replace the existing structured file with 
the contents of the damaged file. 

3. Do one of the following: 

• Select Y to replace the existing structured file 

• Select N to cancel DB2STF. 


Press l 
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DB2STF displays a series of dots on the screen as it processes the 
information in the damaged file. When it finishes, you have a struc¬ 
tured file with the information from the damaged file. 


Reconstructing the Damaged File 


After running DB2STF, you must reconstruct the file. To reconstruct 
the recovered file, you must create a new Agenda file and then 
import the information from the structured file into it. 

To create a new Agenda file: 

1. From the Agenda 2.0 program directory, type agenda and press 


Agenda displays the File Retrieve box. 

2. Type the name of the file to create and press enter. 

Agenda displays the New File box. 

3. Complete Description and Password if desired and press ENTER. 
Agenda creates the new file and displays the Initial View. After you 
import the structured file into the new file, this view contains the 
recovered information. To reduce the amount of time Agenda takes 
to import the information, turn off conditions and actions in this new 
file. 

To turn off conditions and actions: 

1. Press Flo (MENU) and select File Properties. 

Agenda displays the File Properties box. 

2. Highlight Auto-assign settings and press space bar. 

Agenda displays the Auto-assign Global Settings box. 

3. Highlight Text matching and choose Off. 

Repeat Step 3 for the Assignment conditions and Assignment 
actions settings. 





Agenda turns off conditions and actions throughout the file. When 
you finish restructuring the new Agenda file, you use this same pro¬ 
cedure to turn conditions and actions back on. 

To import the information from the structured file to the new Agenda 

1. Press Flo (MENU) and select File Transfer Import. 

Agenda displays the Import Structured File box. 

2. Highlight Import from file and type the name of the structured 
file created by DB2STF. 

You don't need to type the .STF extension. If you're not sure of 
the name, press F3 (choices) and select it from the list of the 
structured files in the current directory. 

3. Highlight Assign to category and type MAIN. 

4. Press ENTER twice. 

Agenda imports the structured file into the new file. The new file 
contains the items and categories from the original file as well as 
additional categories and items with information that DB2STF could 
not place in their original locations. 

Each of the additional categories DB2STF creates is a child of another 
new category called DB2STF. To see this family of categories in the 
category manager, press F9 (CAT MGR). 


Creating a View for 
Recoverable Items 


To use the recoverable items in reconstructing your file, it's a good 
DB2STF 3 V * 6W * nc ^ ut ^ es °f the categories created by 

To add a view for recoverable items: 

1 . In the Initial View, press Flo (MENU) and select View Add. 

2. Highlight View name and type the name of a new view, such as 
Recoverable Items, then press enter. 

3. Highlight Sections and press F3 (choices). 

Agenda displays the category hierarchy. 

4. Highlight the DB2STF category and press F5 (chldrn) to select the 
children of DB2STF as section heads in the new view. Then press 
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Agenda displays the new view with the items from the child catego¬ 
ries of the DB2STF category. The view may contain one or more of 
the following sections: 

• Discarded Items 

• Lost Text 

• Questionable 

• Conditions and Actions 

These sections contain information that DB2STF recovered but 
couldn't associate with an item or category. Use the procedures 
described in the following sections to put this information in the 
proper locations in the new file. 

Tip As you work through these procedures, be sure to periodically 
save the file (press ALT-w). 


Handling The Discarded Items section contains items recovered from the Trash 

Discarded Items of the original file. If you want to keep any discarded items, assign 
them to the appropriate categories. 

To assign items recovered from the Trash to their appropriate catego- 


• Press alt-m. 

If you don't want an item, discard it. When you finish, discard the 
category Discarded Items. 

To discard items and categories: 

• Highlight the item or category to discard and press 
ALT-F4 (DISCARD). 


Reconstructing The Lost Text section in the new view is usually listed last. It con- 
Lost Text tains the items "Lost text number 1," "Lost text number 2," and so 

forth. The notes for those items contain text that was damaged in the 
original file and that is no longer connected with any item, note, or 
category in the new Agenda file. To reconstruct this lost text, cut it 
from the note and paste it where you want it. 




To reconstruct lost text: 


Reconstructing 

Macros 


1. Highlight the first item in the Lost Text section and press 

F5 (NOTE). ' 

Agenda displays the lost text as a note. In some cases the note 
contains a file name or other text that you don't need. In that 
case, press F5 (return) to return to the view, then press 
ALT-F4 (DISCARD) to discard the item. 

2. Press F7 (MARK) and highlight the text to cut. 

3. Press F4 (CUT) to cut the text and press F5 (return) to return to the 


4. Do one of the following: 

• To add the text as an item, highlight an existing item and 


To add the text as a note attached to another item or category, 
highlight the appropriate item or category and press 


To add the text as a category, press w (cat mgr), highlight the 
category under which you want to insert the text as a category 


5. Press F2 (paste) to paste the text in its new location. 


If you pasted the text as a category, press enter to complete the 


6. Follow Steps 1-5 for each item in the Lost Text section. Discard 
each item as you finish with it. 


When you finish reconstructing lost text, discard the Lost Text 
category. 


The Macros section contains the items "Macro number 1," "Macro 
number 2,” and so forth. The notes for those items contain the con¬ 
tents of the macros from your original file. To reconstruct a macro, 
you need to cut the macro contents from the note and paste it into a 


Note If you are recovering an Agenda 1.0/1.01 file, any mac 
include keystrokes may be obsolete in Agenda 2.0 beca 
the changes made to menus and keys. Rather than reo 
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Reconstructing 
Questionable 
Items and Notes 


The Questionable section contains items that have kept their assign¬ 
ments, but have text or notes that are incomplete or otherwise dam¬ 
aged. 


Reconstruct the text or notes of the items you want to keep. If you do 
not want a Questionable item, discard it. When you finish, discard 
the Questionable category. 


Restoring 

Conditional 

Assignments 


If you chose not to change conditional assignments to explicit assign- 
men ^ when you use DB2STF, you need to restore conditional assign- 

As part of reconstructing the file, you turned off conditions and 
actions. You now need to follow the same procedure and turn them 
back on before you apply conditional assignments. Follow the proce- 
d T inJReconstructing the Damaged File" to turn conditions and 

Note If you are recovering an Agenda 1.0/1.01 file, you need to 
re-attach conditions and actions before restoring conditional 
assignments. For more information, see "Reconstructing 
Agenda 1.0/1.01 Conditions and Actions" in the following 


To restore conditional assignments: 


Agenda applies all the conditions in the file to all the items in the file 
thereby restoring the conditional assignments. 


Vl^ys and Ctm9 DB2STF does not include the following parts from your original file: 

Settings 

• Filters 

• Global settings 


You must reconstruct these parts yourself. For information about 
creating filters, see Chapter 11. See the File Properties, Category 
Properties, and Utilities Customize boxes for settings that control 
global functions. For information about creating views see 
Chapter 9. 
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Reconstructing Agenda 1.0/1.01 Conditions and Actions 


If you recover an Agenda 1.0/1.01 file that has conditions and 
actions, the Recoverable Items view includes a section called Condi¬ 
tions and Actions. Each item in this section represents a category that 
has a condition or action. For example, if you have a condition on the 
Terry category in the People family, this section has an item called 
"Conditions and actions for category: \People\Terry". 

As shown in the above example, DB2STF precedes each category 
name with the parent of that category. DB2STF uses three different 
symbols to separate the child and parent categories: 


Symbol Meaning _ 

\ Non-exclusive children 

! Unindexed children 


Each item in this section also has a note that contains the specifica¬ 
tions for that category's conditions and actions. Use this information 
to reconstruct the conditions and actions. Be aware, however, that 
the procedures and terminology for conditions and actions are differ¬ 
ent in Agenda 2.0. For a summary of the changes made to conditions 
and actions, see Chapter 2 in Setting Up Agenda. For more 
information about Agenda 2.0 conditions and actions, see Chapters 18 
through 21. 

After you reconstruct the conditions and actions in Agenda 2.0 for¬ 
mat, restore the conditional assignments: 
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Error Messages 


Agenda displays error messages, warnings, and other notifications to 
provide information about problems that occur while you work. The 
messages Agenda displays are as complete as space allows. Many 
include suggestions on how to proceed. 

Not all messages Agenda displays are included in this appendix 
because many need no additional explanation. Others reflect prob¬ 
lems with the operating system or your network, not with Agenda. 


In this Appendix 


This appendix 

• Provides information about some of the error messages, warnings, 
and notifications you may see while using Agenda 

• Includes all numbered messages that can be intercepted by a 
macro error handler 

This appendix presents error messages alphabetically in three groups: 

• Agenda error messages, warnings, and notifications 

• Utilities error messages 

• Accessories error messages 



Error Messages 


Agenda Error Messages, Warnings, and Notifications 


This section provides information about some of the error messages, 
warnings, and notifications you may see while using Agenda. 
Messages with numbers can be intercepted by a macro error handler 
(#ERRNO and #ERRMSG). For more information about the macro 
error handler, see Chapter 3 in Working with Macros. 

• Agenda can’t access the file to which you want to export Done 
items. The Done items will remain in your current file. 

Notification 6127. 

• Agenda can’t access the printer. 

The printer you requested is inaccessible because it is turned off, 
isn't connected to your computer, is on a network to which you 
aren't connected, or you may have selected an incorrect Port for 
the printer in Print Setup. 

• Agenda can’t display Help. 

You may have the wrong version of Help on your hard disk. Try 
installing Agenda again, using the Installation program on the 
Installation disk. Don't try to copy the Help file using operating 
system commands such as COPY. 

• Agenda can’t find or open the Named print set file you requested. 
Error 6000. 

• Agenda can’t find the file you requested. 

Error 7100. 

• Agenda can’t find the operating system COMMAND.COM file. 

You should refer to your operating system manuals. 

Error 6013. 

• Agenda can’t find the program you requested. Verify what you 
typed and whether you need to add a path name. 

Error 6019. 

• Agenda can’t import the file you requested. Either the file is dam¬ 
aged, or it contains control characters that Agenda can’t accept 
Error 6320. 

- Agenda can’t open the file you requested. You should use a 
different file. 

Error 7101. 



Agenda can’t open the Help file. Try repeating Agenda 
installation. 

Error 6110. 

Agenda can't open the temporary file. Use the DOS command 
SET AG_TMP= and provide a valid path. 

Error 6116. 

Agenda can’t read the file you attached. Either the file is 
damaged, or it contains control characters that Agenda can’t 
accept. 

Error 6004. 

Agenda can’t run the program you requested because the file you 
named isn’t an executable program file (it’s some other type of file) 
or the program’s files are damaged or invalid. 

Error 6023. 

Agenda can’t save the note because your disk is full or there is a 
network or other system error. If you can't correct the system 
problem, you can use the Export command to export the note to 
another file or press ESC to discard the changes to the note. 

Error 6007. 

Agenda can’t save the note file. The disk to which you are saving 
may be full. Try another disk. 

Error 6001. 

Agenda can't save this Named print set file. 

Error 6006. 

The problem could be that you tried to save the file to a disk that 
is full, you used an invalid path, or the file you want to save is a 
read-only file (which means you can save it only by giving it a 
different name). If your disk is full, delete some files. 

Agenda can’t update this file because the .AGB file wasn’t found. 
All Agenda 1.0 and 1.01 files (called databases in 1.0 and 1.01) are 
made up of two files: one with the extension. AGA, the other with 
the extension .AGB. The .AGB file is not a backup file. (The pair 
of backup files have the extensions .BGA and .BGB.) If you delete 
either the .AGA or .AGB file, the database is inaccessible. 

Agenda 2.0 combines these two files. The file extension is .AG. 
The backup file has the extension ,BG. 

Agenda can’t update this file because there is not enough space 
available either on your disk or in the file. 

Error 6324. 
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characters in file names: !©#$%&()_-"{) 

You can't use spaces or any non-alphanumeric characters not in 

The file name you typed exceeds the limit of 8 characters plus a 
3-character extension (such as filename.ext). Enter a valid file 
name. 

Error 6115. 

The file you are attaching as a note or macro contains embedded 
control characters, which Agenda can't recognize. You can read, 
but not edit, this note or macro file. 

Error 6017. 





If you used a word processor to write this file, you should convert 
the file to an ASCI] version before you attach it so that all control 
characters are removed. Many word processors use control char¬ 
acters for formatting codes that are embedded in the file and may 
not be visible when you display the file in the word processor. 

The file you attached is marked in DOS as read-only, so you will 
not be able to edit it. 

Notification 6214. 

The file you requested doesn’t exist. Check the name you typed 
for errors and make sure you specified the correct directory. 

Error 6109. 

The file you requested is being used by another user. Agenda will 
try again. 

Notification 6605. 

The file you requested was created with a version of Agenda 
higher than the one installed on this computer. If you want to use 
this file, you need to upgrade your version of Agenda. 

Error 6113. 

The file you want to import is not a valid structured file (STF). You 
can use the TXT2STF and LM2STF utilities or the File Transfer 
Export command to create a structured file. 

Notification 5035. 

The highlight isn’t on a category. Highlight the category you want 
and repeat the command. 

Error 6300. 

The highlight isn’t on an item. Highlight the item you want and 
repeat the command. 

Error 6100. 

The highlight isn’t on an item, so Agenda can’t print your request. 
Highlight the item you want and repeat the Print command. 

The highlighted category has no condition or action to copy. 
Notification 6215. 

If you convert this category to a date category, the current child 
categories will be lost (unless they are dates); date categories can 
contain only dates. 

Warning 6600. 
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The name of the section head must contain at least one character 
(other than a space). Type a valid category name or press F3 to 
choose an existing category. 

Error 6311. 

The Named print set file you requested is damaged. You should 
delete damaged files from your hard disk. 

Error 6305. 

The Named print set file you requested doesn’t exist. You can't 
attach a non-existent Named print set file to a view. 


The Named print set file you requested isn’t valid or is from a 
previous version of Agenda (and can't be used with this version of 
Agenda; delete the file from your hard disk). 

Error 6306. 

If the file extension is not .NPS, then the file isn't a valid Named 
print set file. If the extension is .NPS, then the file is obsolete, and 
you should delete it. 

The note or macro file you want to import is too large (more than 
10K). Agenda will import as much as possible (up to 10K). You 
can edit the file, but not if editing adds to the file so that it exceeds 
10K. 

Notification 6207. 

This note is read-only because the category is protected. 
Notification 6016. 

Notes this long can only be viewed (read-only). 

Notification 6200. 

The number you entered for expanded memory isn’t valid. Enter a 
0 (for no expanded memory) or any number between 64 and 

Error 6318. 

The number you entered for Minimum value was greater than the 
number you entered for Maximum value, so Agenda switched the 
values. 

Notification 6303. 

The number you entered for virtual memory isn’t valid. Enter any 
number between 512 and 8192. 


Error 6317. 




iting. Check the 
le Properties 
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There are no discarded items in the trash, so there is no trash to 
empty. 

Notification 6704. 

There are no Help screens for the topic you typed. Try typing a 
less specific topic. 

Notification 6219. 

There are no marked items in the file. 

Notification 6212. 

There are no marked items in this view, so Agenda can't print your 
request. Mark the items you want and repeat the Print command. 
Error 6123. 

There is already a macro attached to the key. If you want to use 
this key for the current macro, you must detach the original macro, 
and repeat the attachment of this macro to the key. 

Error 7105. 

There is no file attached to the current note or macro, so Agenda 
can’t detach one. 

Notification 6220. 

There is no file attached to the current note or macro, so Agenda 
can’t erase one. 

Notification 6221. 

There is no room in this view to add a new column. 

Notification 6708. 

There isn’t enough room in the file for the text you entered or 
attached, so Agenda shortened the text. 

Notification 6208. 

To make an item dependent, you must first highlight the 
prerequisite item(s) and mark them by pressing F7. 

Notification 6101. 

To use this feature, you must start Agenda by typing AGENDA, 
not A. Quit Agenda and start again if you want to use the feature. 
Notification 6126. 

Unable to preview document; invalid graphics display driver. 
Agenda can't display a preview of your printed document 
because the graphics display driver you selected when you 
installed Agenda isn't the same as the graphics display hardware 
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in your computer. To change the type of graphics display driver, 
select the Print Setup command and pick the graphics display 
driver that matches your hardware. 

The version of Help on your hard disk isn’t compatible with your 
version of Agenda. Repeat Agenda 2.0 installation. 

Error 6112. 

This view contains protected column(s). Changes you make to 
columns in the current section won't apply to the protected 
column(s). 

Notification 7009. 

The view name must contain at least one character (other than a 
space). Type a valid view name. 

You assigned all marked items to a category with a special action 
that discarded the items when you made the assignment. You 
can recover the items from the trash (unless you have set Empty 
trash to When item is discarded). 

Notification 6711. 

You assigned the current item to a category with a special action 
that discarded the item when you made the assignment. You can 
recover the item from the trash (unless you have set Empty trash 
to When item is discarded). 

Notification 6706. 

You can copy or move items only to another section, and this view 
contains only one section. If you want to reposition the item within 
the section, use the Item Reposition command. 

Notification 6304. 

You can enter the page-number marker only in a header or footer. 
Notification 6705. 

You can’t add any categories to this file because none of the 
categories in the file can have child categories. 

Protection 7013. 

You can’t add child categories for this category. 

Protection 7004. 

You can't add items to this section because a filter or action 
prohibits any new items. 

Notification 6119. 

You can’t add new views to this file because the file is protected. 
Protection 7011. 







You can’t change the category type of date, numeric, and 
unindexed categories. 

Notification 6204. 


You can’t change the properties of this column because the 
column is protected. 

Protection 7008. 


You can’t convert the MAIN category or a category with 
grandchildren to numeric, date, or unindexed. 
Notification 6003. 


You can’t 
Error 601; 
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. J this view or make this chanc 

is protected. 

Protection 7001. 

You can’t display the macro manager here. 

Notification 6202. 

You can’t divide a number by zero. Rewrite the expression in 
macro. (Check values for variables, if there are any.) 

Error 7103. 


a header or footer. 


You can’t export any more Done items because the disk with 
file of Done items is full or otherwise inaccessible. Correct the 
problem with the Done file or change the Process Done Items 
setting in File Properties Global Date settings. 

Error 6102. 


You can’t make this change in a datebook view. 
Protection 7012. 


You can’ 
Protectio 








You cant move this item because its category assignments would 
conflict. 

Notification 6206. 

You can't perform this operation on a protected macro. 

Notification 6201. 

You can't promote or demote this category because of its 
relationship to a protected category. You can't change the 
parent of a protected category. 

Protection 7006. 

You can’t promote this category. 

Notification 6709. 

You can't remove the item column from the section. 

Notification 6018. 

You can't rename a file while it is open. 

Notification 6211. 


You can’t run this macro in this part of Agenda. Macros can be 
limited to any one or more of these parts of Agenda: views, the 
category manager, and notes. 

Notification 6716. 

You can check where a macro can run by displaying the Macro 
Properties box for the current macro (press F6 (props) on the 
highlighted macro name). 

You can't use ALT-F9 to copy (duplicate) a section or column. 

You can, however, use ALT-F10 to move a section or column. 
Notification 6700. 

You can’t use print features because they aren’t installed. To 
install them, quit Agenda and run the Installation program from 
your hard disk. 

You can’t use print features until you select a primary printer in the 
Print Setup box. Press any key and issue the Print Setup 
command. 

Error 6325. 

You can’t use the file name you typed because it's an operating 
system reserved name. Enter a different name for the file. 

Error 6106. 
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The four Agenda application Hies are: ACCOUNT AG, INFO- 
SIFT AG, PEOPLEAG, and PLANNERAG. You must copy you 
versions of these files into a different directory if you want to kei 
the information you've entered in them. During installation. 
Agenda will write the original (blank) versions over your files. 
Don't try to bypass this process by using the DOS COPY com¬ 
mand to copy the Help file to your hard disk. The Help file is a 
compressed file, and you can't copy compressed files. 


Utilities Error Messages 


This section provides additional information about some of the error 
messages you may see while using the Agenda utility LM2STF 
(List Manager to Structured Text File). LM2STF lets you convert a file 
you created with the Lotus Metro List Manager to a structured text 
file that you can import into Agenda. Error message are listed 
alphabetically. 

Error messages for the Agenda utility TXT2STF (Text to Structured 
Text File) are explained in Appendix D of Working with Definition 

• Access denied 

You can't open the file you requested because either it is a read¬ 
only file, or it has already been opened by another network user. 
To gain access to the file, remove the read-only protection or trv 
again later. ’ 

• Disk is write-protected 

The disk you specified for the output file is write-protected. 
Remove or reset the disk's write-protect tab or use a different disk. 

• Drive not ready 

LM2STF tried to save a file and the drive door was open or the 
disk wasn't fully inserted. Close the drive door or reinsert the 
disk and repeat the command. 
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• You must type the name without an extension 

You entered a List Manager file name with an extension. Retype 
the List Manager file name without an extension. 


Accessories Error Messages 


This section provides additional information about some of the error 
messages you may see while using accessories with Agenda. 

The error messages are in alphabetical order in these sections: 

• Installation error messages 

• Start-up error messages 

• Call-up error messages 

• General error messages 

Installation This section explains an error message you may see while installing 

Error Messages the accessories. 

• Main program (METRO.EXE) not copied to destination 
Your hard disk contains a newer version of the main Metro 
program than the one you tried to install. No action is necessary. 
Use the version already installed. 

Start-UD This section explains the error messages you may see when you start 

Error Messages the accessories. 

• Bad driver version 

The Metro display driver (.SDR file) you tried to use is not the 
right version. Make sure that all the .SDR files from the installa¬ 
tion disk are in your Metro directory. 

• Cannot run Metro — already present in memory 

You tried to start Metro when it was already in memory. If you 
want to start Metro again (for example, to implement new set¬ 
tings), return to the operating system level, press SHIFT ALT END to 
unload Metro, and try to start Metro again. If you still get this 
message, reboot your computer. 
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• Cannot run Metro — wrong version of DOS 

You need to use DOS version 2.0 or higher to run Metro. You 
need to use version 2.1 or higher to run Agenda, so you should 
upgrade to at least version 2.1. 

• Error loading driver 

Metro cannot find the Metro display drivers (.SDR files). Make 
sure that all the .SDR files from the installation disk are in your 
Metro directory. 


Call-up 

Error Messages 


This section explains the error messages you may see when you call 
up one of the accessories. 

• Accessory missing 

The accessory you called up doesn't exist. You might have 
pressed the wrong alt-shift combination. Use the Configuration 
accessory to check key assignments. If the accessory is missing, 
reinstall it from your original Agenda disk. 

• File error loading accessory 

Agenda can't call up the accessory you requested. Check for a 
damaged disk or a bad network connection. If you see this mes- 

• Insert disk containing accessory 

Agenda can't find the accessory you requested on the disk drive 
you specified. Check the disk drives to make sure that you are 
using a disk with the appropriate accessories and that you have 
closed the drive doors. 


• Keyboard assignment missing 

Agenda can't call up the accessory you requested because there is 
an error in the table used to assign call-up keys. Press ESC to clear 
the message. Hold down shift and ALT together until the menu 
pops up. This procedure rebuilds the table. 

• Not enough memory to run accessory 

There is not enough memory currently available to call up the 
accessory you requested. Put away any active accessories, erase 
the Clipboard, and try again. If you get this message repeatedly, 
change the amount of memory allocated to Metro. 


I 
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General 

Error Messages 


■ Unable to reload accessory 

You called up one accessory over another and tried to quit the 
second accessory. Metro cannot find the accessory file for the first 
accessory in the \METRO directory because you have deleted the 
file or removed the disk that contains the accessory file. Press any 
key to put away the missing accessory. Note that you will lose 
any work in progress in that accessory. 

• Wrong version of accessory 

You can't run a Spotlight 1.1 accessory with Metro. Delete the 
Spotlight accessories from the Metro directory. 


This section explains the error messages you may see while using the 
accessories. 

• Cannot find system directory 

Metro cannot find the \MBTRO directory that contains the files 
that the accessories require. You either deleted the directory that 
contains the accessories or are running from a disk and removed 


• Clipboard is too small to hold all the requested data 

You do not have enough memory to copy the data you requested 
to the Metro Clipboard. Quit any active accessories and try again. 
If you still get this error message, allocate more memory to Metro. 

• Clipboard too small to copy page 

(Items accessory) You don't have enough memory allocated to 
Metro for the contents of the item to be copied to the Metro Clip¬ 
board. Either allocate more memory to Metro or, if you have 
other accessories loaded, quit them. 

• Device not ready 

Metro can't access the disk drive you want to use because its door 
is open or the disk is not firmly inserted. Close the disk drive 
door or make sure the disk is firmly in place. 

• Disk is full 

The disk you want to use is full. Delete some files from the disk or 
use a different disk. 
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• Unable to write to file 

(Items accessory) You selected the Transfer or Print 
but the operating system won't let you perform the t 
problem may occur because you either specified a re 
you have too many files open. Try using another file 
the Transfer command). If rhantfine the file name d, 
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